Arkos2Basic

Converts Arkos Tracker 3 text exports to CVBasic MUSIC blocks. Handles note transposition, variable note duration, percussion detection and intro/loop splitting. Targets ColecoVision, MSX and Sega SG-1000.

Installation

pipx install arkos2basic

What if you don’t have pipx installed?

Depending on your OS, you can install pipx with this command:

MacOS

brew install pipx

Linux

sudo apt install pipx

Usage

Export your song from Arkos Tracker as a TXT file, then launch this command:

arkos2basic <input-file> <output-file>

If your song has a loop, the app will provide you with two files:

<output-file-path>/<output-file-stem>.bas
<output-file-path>/<output-file-stem>_loop.bas

Example

Let's imagine you have a TXT source file named mymusic.txt in the same folder of your CVBasic project.

Convert the source file with the command:

arkos2basic mymusic.txt mymusic.bas

If the song has a loop, arkos2basic will provide you these two files:

mymusic.bas
mymusic_loop.bas

To test if the music has been properly converted, create a test_music.bas file with this code:

DIM loop_on
loop_on = 0
PLAY FULL
PLAY mymusic
DO
    WAIT
    IF MUSIC.PLAYING = 0 AND loop_on = 0 THEN
        loop_on = 1
        PLAY mymusic_loop
    END IF
LOOP WHILE 1

INCLUDE mymusic.bas
INCLUDE mymusic_loop.bas

Requirements

Python 3.10 or better.

Download files

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

Source Distribution

arkos2basic-26.8.0.tar.gz (22.5 kB view details)

Uploaded Aug 30, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

arkos2basic-26.8.0-py3-none-any.whl (25.6 kB view details)

Uploaded Aug 30, 2026 Python 3

File details

Details for the file arkos2basic-26.8.0.tar.gz.

File metadata

Download URL: arkos2basic-26.8.0.tar.gz
Upload date: Aug 30, 2026
Size: 22.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for arkos2basic-26.8.0.tar.gz
Algorithm	Hash digest
SHA256	`2beb4fd74642b6e95f1d2efa5e3eedc841bcdc13ab1c31aca975e780ce1fa804`
MD5	`2fa8b7000b7071e6458fb27abbd37254`
BLAKE2b-256	`234106fddc7d2d0cb5dfe4bfa670f739e9f8f5e5fe742a8b025eefadc695a9bc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for arkos2basic-26.8.0.tar.gz:

Publisher: publish.yml on fmaida/arkos2basic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: arkos2basic-26.8.0.tar.gz
- Subject digest: 2beb4fd74642b6e95f1d2efa5e3eedc841bcdc13ab1c31aca975e780ce1fa804
- Sigstore transparency entry: 2651422142
- Sigstore integration time: Aug 30, 2026
Source repository:
- Permalink: fmaida/arkos2basic@a19b37357515d69507366c67b4bd09d9916b8e2d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/fmaida
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@a19b37357515d69507366c67b4bd09d9916b8e2d
- Trigger Event: push