TeensyROM Command Line Interface

A cross-platform CLI Tool for TeensyROM Emulator, Fast Loader, MIDI and Internet cartridge for Commodore 64/128.

Demo

Demonstration of the various streaming / file launching capabilities.

cli-demo-alpha.26.mp4

Features

• Cross platform support for Windows, MacOS, and Linux
• Guided / BBS style interface
• Remote File Launching
• Auto-play of SIDs, games and images like a streaming service.
• Tag favorites
• Ban stinkers
• Search your collection by name, artist, STIL descriptions and more.
• Navigate your SD/USB storage manually
• Single Line Command Support

Installation

• Windows

  • Unzip and run TeensyRom.Cli.exe

• Linux

  • You all know what to do.

• Mac

  • I don't have a Mac Developer license, so you'll need to install using Homebrew.
  • To add the repostory: brew tap MetalHexx/TeensyROM-CLI https://github.com/MetalHexx/TeensyROM-CLI
  • To install: brew install MetalHexx/TeensyROM-CLI/teensyrom-cli

BBS Style Menu System

• Run the command: teensyrom.cli cs
• Follow the prompts
• Launch menu is the star of the show. Start a stream and enjoy!

Using Command Line Parameters

You can specify everything by a command prompt for things like automation or whatever you can think up

• Type teensyrom.cli cs -h for help
• Example command w/ options: teensyrom.cli cs --source c:\your\patch\directory --target ASID --clock ntsc

Chipsynth C64 ASID Preset Generator

Chipsynth has terrific functionality to support ASID MIDI streaming to external hardware. However, the feature is a bit experimental and has a few pain points when switching between presets. See videos below.

TeensyROM / Chipsynth ASID Demo

Chipsynth Pain Points Demo

Plogue Forum Discussion on the issues <-- Come support the thread and chime in if you'd like to see the integration improved!

TeensyROM Hardware ASID Player Documentation <-- Read more about the TeensyROM ASID functionality here!

Solution

This tool aims to fix 3/4 of the issues by creating a clone of all your Chipsynth presets with the following defaults:

• Sets VOLUME to 0 (to silence the emulated SID)
• Sets POLY to 1 (Only mono is supported from Chipsynth)
• Sets the SID CLOCK to your preference
• Note: You must still re-select "SYNTH V1" when switching between ASID patches.
  • This is a known issue that is still unresolved by Plogue.
  • See the Plogue forum thread mentioned above for more details.
• New presets are generated in a new folder

Generating Presets

• The chipsynth preset directory and all child directories will be scanned for .fermatax files (these are preset files)
• The process will make a copy of your presets and put them in a new folder with ASID friendly settings.
• The process will not overwrite the existing factory patches.
• The new presets will show up in your preset browser the next time you start Chipsynth

Locate your Preset Directory

• Locate your Chipsynth C64 preset directory.
  • Ex: C:\music\chipsynth C64\Presets\com.Plogue.Fermata.chipsynth C64
• Copy the path for the preset folder.
• You will use this as the "source" directory in the tool
• Backup your factory presets as a best practice

New Patches in Chipsynth

Your patches are generated in a new sub-directory as seen below. Enjoy!

Troubleshooting

Depending on where your patches are located, you may need to run the tool with elevated "Admin" rights. You may get the error below if this is the case.

Additional Notes

• The Linux and Mac releases are untested. So if you try them and they don't work, please let me know and we can make it happen.
• If you need help, seek out hExx on the TeensyROM Discord Server
• Target Chipsynth Version: v1.006
• Untested with other versions.