https://github.com/sks316/bcml-steamdeck
Installer script for BCML on Steam Deck
https://github.com/sks316/bcml-steamdeck
bcml breath-of-the-wild breathofthewild steam-deck steamdeck
Last synced: 9 months ago
JSON representation
Installer script for BCML on Steam Deck
- Host: GitHub
- URL: https://github.com/sks316/bcml-steamdeck
- Owner: sks316
- License: mit
- Created: 2022-08-07T06:23:06.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-05T02:24:11.000Z (almost 2 years ago)
- Last Synced: 2025-05-04T23:23:53.875Z (about 1 year ago)
- Topics: bcml, breath-of-the-wild, breathofthewild, steam-deck, steamdeck
- Language: Shell
- Homepage:
- Size: 64.5 KB
- Stars: 36
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Deprecation Notice
BCML has been discontinued by its developers in favor of a new mod manager, the U-King Mod Manager (UKMM). I will continue to maintain this installer script for those who wish to use BCML, especially as UKMM appears to be incompatible with some mods, but I do recommend trying UKMM first.
[Download UKMM here.](https://gamebanana.com/tools/12110)
# BCML Installer for Steam Deck
BCML can be difficult to get running on Steam Deck, because it uses an immutable filesystem and the version of Python installed by default is higher than what BCML supports. So I made a script to help people install it.
[Requires Miniconda with Python 3.8.](https://repo.anaconda.com/miniconda/Miniconda3-py38_23.1.0-1-Linux-x86_64.sh)
# The obligatory explanation of why the script exists and what it does
The version of Python on the Steam Deck is 3.10. This makes BCML incompatible, as it only works on lower versions. The Steam Deck uses an immutable filesystem, which basically means that packages installed on the OS level cannot be modified, hence why the Discover store uses Flatpak, which installs programs to your home directory. Under normal circumstances, this would mean that we can't install older versions of Python and, as such, BCML. Luckily, a neat project called Miniconda exists.
Miniconda creates a totally isolated installation of Python in your home directory, which is one of the few directories that can be modified on an immutable filesystem like Steam Deck uses. This makes it perfect for this purpose. But Miniconda isn't the most user-friendly, especially if you're not a developer. So I saw it fit to automate everything you need to use Miniconda for. That's what this script does. The only thing I couldn't automate was the installation of Miniconda itself, so I direct the user to do that.
First, the script asks the user if they want to install BCML. If the user chooses no, the script closes and does nothing else.
If the user chooses yes, then the script checks if Miniconda exists on the system. If Miniconda doesn't exist on the system, the script shows a pop-up asking the user to install Miniconda. Then, the script closes. If Miniconda exists, then installation continues.
It runs `conda init`, which finishes setup of conda and adds it to your $PATH. This makes it easier to run Python commands within your Miniconda installation in the future.
It then directs Miniconda to install gcc and pip. gcc is required to install dependencies for BCML, if it's not present then installation will almost-certainly fail. pip is the installer for Python packages, it's what we use to install BCML itself.
It then directs pip to install BCML. This is the most lengthy part of the installation.
After that, it makes a new hidden directory to store the icon for the desktop in. It then downloads the icon and the desktop shortcut, and stores them in the correct places.
All of this is logged to `bcml_installer.log` in your home directory.
Once this is all done, it displays one more pop-up stating that installation is finished.