Skip to main content

X16 Command Line Interface for assembly projects.

Project description

X16 Command Line Interface

X16 Command Line Interface is a tool for assembly projects. Features:

  • Downloading and building of compiler, emulator and rom
  • Default configuration should just work
  • Build and run with one command
  • Easy to read configuration file


The first command you should use in your project folder is x16 init. X16Cli downloads the compilation tools in a hidden folder and creates a toml configuration file.

The hello world project does nothing. You are free to start from the main.asm file.

If you want to change the starting point you just have to edit the config file under compiler.source section.

Multiple Files

Every other .asm file (except the main) should be added to the config file in the modules list. The include files (.inc) shouldn't be added.

The modules compiled this way should export the right symbols (please look at cc65 documentation for that).


X16Cli is actively developed and tested on Linux Ubuntu. If you are a Mac or Windows user you may consider to help me supporting these platforms too. Thank you.

Linux Ubuntu

  • Python >= 3.6
  • sudo apt install build-essential git

If something is missing here, please reach out to me.


You should only need to do this in the right environment:

pip install x16cli

Or, something like that for user level:

pip3 install x16cli --user

You should have the pip3 user binary folder in your system PATH to have easy access to x16 script.

Getting Started

mkdir myprj-folder
cd myprj-folder
x16 init
x16 run

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

x16cli-0.1.1.tar.gz (4.8 kB view hashes)

Uploaded Source

Built Distribution

x16cli-0.1.1-py3-none-any.whl (18.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page