https://github.com/combatopera/pym2149
YM2149 emulator supporting YM files, OSC to JACK, PortAudio, WAV
https://github.com/combatopera/pym2149
Last synced: about 1 year ago
JSON representation
YM2149 emulator supporting YM files, OSC to JACK, PortAudio, WAV
- Host: GitHub
- URL: https://github.com/combatopera/pym2149
- Owner: combatopera
- License: gpl-3.0
- Created: 2017-01-14T11:30:13.000Z (over 9 years ago)
- Default Branch: trunk
- Last Pushed: 2025-01-29T08:17:36.000Z (over 1 year ago)
- Last Synced: 2025-03-24T16:47:58.849Z (over 1 year ago)
- Language: Python
- Homepage: http://ym2149.org/
- Size: 4.53 MB
- Stars: 9
- Watchers: 3
- Forks: 0
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# pym2149
YM2149 emulator supporting YM files, OSC to JACK, PortAudio, WAV
## Install
These are generic installation instructions.
### To use, disposably
Install the current release from PyPI to a virtual environment:
```
python3 -m venv venvname
venvname/bin/pip install -U pip
venvname/bin/pip install pym2149
. venvname/bin/activate
```
### To use, permanently
```
# Tested on Linux and Mac:
pip3 install --break-system-packages --user pym2149
```
See `~/.local/bin` for executables.
### To develop
First install venvpool to get the `motivate` command:
```
pip3 install --break-system-packages --user venvpool
```
Get codebase and install executables:
```
git clone git@github.com:combatopera/pym2149.git
motivate pym2149
```
Requirements will be satisfied just in time, using sibling projects with matching .egg-info if any.
## Usage
```
# Play a tune written in the Lurlene live coding language:
lc2portaudio 'contrib/Jochen Hippel - 7 Gates of Jambala Level 9.py'
lc2jack 'contrib/Jochen Hippel - 7 Gates of Jambala Level 9.py'
# Play a Dosound sound effect:
dosound2jack contrib/sounds.s snd19
```
## Commands
### bpmtool
Show a table of speed (updates per tracker line) to BPM.
### dosound2jack
Play a Dosound script via JACK.
### dosound2txt
Render a Dosound script to logging.
### dosound2wav
Render a Dosound script to WAV.
### dsd2wav
Render Dosound bytecode to WAV.
### lc2jack
Play a Lurlene song via JACK.
### lc2portaudio
Play a Lurlene song via PortAudio.
### lc2txt
Render a Lurlene song to logging.
### lc2wav
Render a Lurlene song to WAV.
### mkdsd
Compile Dosound DSL scripts to bytecode for playback on a real Atari.
### ym2jack
Play a YM file via JACK.
### ym2portaudio
Play a YM file via PortAudio.
### ym2txt
Render a YM file to logging.
### ym2wav
Render a YM file to WAV.