KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

bc250-toolkit

★ 84 Open GitHub ↗

Setup script for BC250 on CachyOS

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# bc250-toolkit
Setup script for BC250 on CachyOS
(However, the current script does aim to work across other arch distros and the grub bootloader, but has not been tested yet.)

Disclaimer:  I am not responsible for any damages caused by use of this script.  Please review it to make sure the overclocking configs are compatible with your board. Unlocking compute units will increase power draw and heat.  You are responsible for your own power and cooling setups.  Misuse of this script could cause physical damage to your board.

### **Must be using Limine boot loader for all functions in the script to work.**  (Grub support added in the pre-release version, but needs testing.)

This script will allow easy setup of the BC-250 on CachyOS.  It has been tested with the handheld edition, but should also work on any CachyOs version as long as the Limine bootloader is used.  Inspired by the similar script for Bazzite:  https://github.com/NexGen-3D-Printing/SteamMachine

It does the following:
1. Install CPU governor: https://github.com/bc250-collective/bc250_smu_oc/
2. Install GPU governor: https://github.com/filippor/cyan-skillfish-governor
3. Enable swap
4. Hide the RDSEED error displayed on boot.
5. Enable ZSWAP
6. Easily change CPU and GPU overclock settings on the fly
7. Displays a status window showing you your current settings.
8. Unlock compute units thanks to: https://github.com/WinnieLV/bc250-cu-live-manager
9. Set vram split and ttm pages: https://github.com/fanoush/bc250_memcfg
10. Unlock CPU Cores: https://github.com/rw-r-r-0644/bc250-core-unlock , https://github.com/Hexxeh/bc250-efi-core-unlock
11. Install ACPI Fix: https://github.com/mendesrr/bc250-acpi-fix-updated-8c

In desktop mode run the below in the terminal(Konsole):
<pre>
curl -sSLO https://raw.githubusercontent.com/redbeard1083/bc250-toolkit/main/bc250-toolkit.sh && chmod +x bc250-toolkit.sh && ./bc250-toolkit.sh
</pre>
As it is a frequently asked question, to re-run the script after running it the first time:
<pre>
./bc250-toolkit.sh
</pre>

```
  ╔══════════════════════════════════════════════════════════════╗
  ║                                                              ║
  ║              CachyOS BC250 Toolkit                           ║
  ║           System Setup & Configuration                       ║
  ║                                                              ║
  ╚══════════════════════════════════════════════════════════════╝

Performance
  ──────────────────────────────────────────────────────────────
  [ 1]  Performance Profiles CPU & GPU performance profiles

Setup
  ──────────────────────────────────────────────────────────────
  [ 2]  Initial Setup       System configuration tasks
  [ 3]  Additional Tools    Additional system utilities
  [ 4]  Revert Menu         Undo previously applied settings

System
  ──────────────────────────────────────────────────────────────
  [ S]  Status              Current system summary
  [ U]  Update Toolkit      Download and install the latest version from GitHub
  [ 0]  Exit

══════════════════════════════════════════════════════════════
  Enter selection: 
...
  ╔══════════════════════════════════════════════════════════════╗
  ║                                                              ║
  ║              CachyOS BC250 Toolkit                           ║
  ║           System Setup & Configuration                       ║
  ║                                                              ║
  ╚══════════════════════════════════════════════════════════════╝

Initial Setup
  ──────────────────────────────────────────────────────────────
  Run these tasks to configure your BC-250 system.

[ 1]  CachyOS Kernel      Replace Deckify kernel with standard CachyOS
  [ 2]  CPU Governor        bc250-smu-oc CPU overclock service
  [ 3]  GPU Governor        cyan-skillfish GPU governor service
  [ 4]  Enable Swap         16G Btrfs swapfile, swappiness=180
  [ 5]  ZRAM -> ZSWAP       Disable ZRAM, enable ZSWAP w/ lz4
  [ 6]  Hide RDSEED Warning Set loglevel=0 in /boot/limine.conf
  [ 7]  Disable Mitigations Add mitigations=off to limine.conf
  [ A]  Run All (1-7)       Run all setup tasks in sequence

⚠  Manual Steps — not included in Run All
  ──────────────────────────────────────────────────────────────
  [ 8]  Compute Units Unlock

[ 0]  Back

══════════════════════════════════════════════════════════════
  Enter selection: 
...

╔══════════════════════════════════════════════════════════════╗
  ║                                                              ║
  ║              CachyOS BC250 Toolkit                           ║
  ║           System Setup & Configuration                       ║
  ║                                                              ║
  ╚══════════════════════════════════════════════════════════════╝

Performance Profile Menu
  ──────────────────────────────────────────────────────────────
  Active: Aggressive — CPU 3500MHz / GPU 2000MHz / max 80°C

Standard Profiles
  ──────────────────────────────────────────────────────────────
  [ 1]  Stock               CPU 3.5GHz, GPU 1500MHz — 80°C
  [ 2]  Mild                CPU 3.5GHz, GPU 1600MHz — 80°C
  [ 3]  Moderate            CPU 3.5GHz, GPU 1750MHz — 80°C
  [ 4]  Strong              CPU 3.5GHz, GPU 1850MHz — 80°C
  [ 5]  Aggressive          CPU 3.5GHz, GPU 2000MHz — 80°C

High-Risk Profiles  ⚠  Requires OC acknowledgement
  ──────────────────────────────────────────────────────────────
  [ 6]  Extreme I ⚠       CPU 3.5GHz, GPU 2100MHz — 80°C  [HIGH RISK]
  [ 7]  Extreme II ⚠      CPU 3.85GHz, GPU 2100MHz — 80°C  [HIGH RISK]
  [ 8]  Extreme III ⚠     CPU 4GHz, GPU 2350MHz — 90°C  [HIGH RISK]

[ C]  Custom              Mix & match CPU and GPU profiles
  [ E]  Edit with Kate      Manually edit GPU config
  [ 0]  Back to Main Menu

══════════════════════════════════════════════════════════════
  Enter selection:

...

bc250-toolkit

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README