Skip to main content

​
Installing DevCPC CLI

DevCPC CLI can be installed automatically using a single command, or manually if you prefer more control over the installation process.

​
Automated Installation

The easiest way to install DevCPC is using the automated installer.

​
Using curl

curl -fsSL https://destroyer.me/devcpc | bash

​
Using wget

wget -qO- https://destroyer.me/devcpc | bash

​
What the Installer Does

The automated installer:
  1. Downloads the latest version of DevCPC
  2. Installs it to ~/.DevCPC
  3. Automatically configures your shell (bash/zsh)
  4. Adds DevCPC to your PATH

​
Post-Installation

After installation, reload your shell configuration: 
source ~/.bashrc
Or simply open a new terminal window.

​
Verify Installation

Check that DevCPC is installed correctly: 
devcpc version
You should see output similar to: 
DevCPC CLI v1.1.0

​
Manual Installation

If you prefer to install manually, follow these steps:
1

Download the latest release

Download the latest version from GitHub Releases
2

Extract the archive

tar -xzf DevCPC-X.Y.Z.tar.gz
3

Run the setup script

cd CPCDevKit
./setup.sh
4

Reload your shell

source ~/.bashrc  # or ~/.zshrc

​
Platform-Specific Notes

DevCPC works on both Apple Silicon (ARM64) and Intel (x86_64) Macs.Requirements:
  • macOS 10.15 or later
  • Xcode Command Line Tools (for development)
  • Python 3.x (usually pre-installed)
Install Command Line Tools:
xcode-select --install
DevCPC supports both ARM64 and x86_64 architectures.Requirements:
  • Python 3.x
  • bash or zsh shell
Install Python (if needed):
# Debian/Ubuntu
sudo apt-get install python3 python3-pip

# Fedora/RHEL
sudo dnf install python3 python3-pip

# Arch Linux
sudo pacman -S python python-pip
DevCPC runs on Windows Subsystem for Linux (WSL) or Git Bash.Using WSL (Recommended):
  1. Install WSL
  2. Install a Linux distribution (Ubuntu recommended)
  3. Follow the Linux installation steps above
Using Git Bash:
  1. Install Git for Windows
  2. Open Git Bash
  3. Run the automated installer
Git Bash support is limited. WSL is the recommended approach for Windows users.

​
Installing Optional Dependencies

​
SDCC (C Compiler)

Only required if you want to compile C code for your CPC projects. 
brew install sdcc
Verify installation: 
sdcc --version

​
RetroVirtualMachine

Only required if you want to use devcpc run to test your projects in an emulator.
Important: Only version v2.0 BETA-1 R7 (10/07/2019) is supported. This is the only version with development options enabled.
Download from: RetroVirtualMachine Website After installation, configure the path in your devcpc.conf: 
RVM_PATH="/Applications/Retro Virtual Machine 2.app/Contents/MacOS/Retro Virtual Machine 2"

​
Pillow (Python Library)

Only required if you want to convert PNG images to ASM sprites or SCN screens. 
pip3 install Pillow
Verify installation: 
python3 -c "import PIL; print('Pillow OK')"
Expected output: 
Pillow OK

​
Updating DevCPC

​
Using the Update Command

The easiest way to update: 
devcpc update
This will:
  1. Check for the latest version
  2. Download and install updates automatically
  3. Preserve your projects and configuration

​
Manual Update

You can also reinstall using the automated installer: 
rm -rf ~/.DevCPC
curl -fsSL https://destroyer.me/devcpc | bash
Your projects are stored separately, so reinstalling DevCPC won’t affect them.

​
Uninstalling DevCPC

To remove DevCPC from your system: 
rm -rf ~/.DevCPC
Then remove the PATH configuration from your ~/.bashrc or ~/.zshrc: 
# Remove these lines:
export DEVCPC_PATH="$HOME/.DevCPC"
export PATH="$DEVCPC_PATH/bin:$PATH"

​
Troubleshooting

The PATH wasn’t configured correctly. Try:
source ~/.bashrc  # or ~/.zshrc
If that doesn’t work, verify the PATH is in your shell config:
cat ~/.bashrc | grep DEVCPC
You should see:
export DEVCPC_PATH="$HOME/.DevCPC"
export PATH="$DEVCPC_PATH/bin:$PATH"
Make sure the DevCPC scripts are executable:
chmod +x ~/.DevCPC/bin/*
Install Python 3:
# macOS
brew install python3

# Ubuntu/Debian
sudo apt-get install python3

# Fedora
sudo dnf install python3
If devcpc update fails, manually reinstall:
rm -rf ~/.DevCPC
curl -fsSL https://destroyer.me/devcpc | bash

​
Next Steps

Quick Start

Now that DevCPC is installed, create your first CPC project!

Build docs developers (and LLMs) love

Get started for freeTalk to us