Metadata-Version: 2.1
Name: pym2149
Version: 34
Summary: YM2149 emulator supporting YM files, OSC to JACK, PortAudio, WAV
Home-page: https://github.com/combatopera/pym2149
Author: Andrzej Cichocki
Author-email: 3613868+combatopera@users.noreply.github.com
Description-Content-Type: text/markdown
License-File: COPYING
Requires-Dist: aridity>=78
Requires-Dist: diapyr>=26
Requires-Dist: lagoon>=31
Requires-Dist: Lurlene>=13
Requires-Dist: minBlepy>=16
Requires-Dist: numpy>=2.0.2
Requires-Dist: outjack>=15
Requires-Dist: pyrbo>=13
Requires-Dist: splut>=4
Requires-Dist: timelyOSC>=4

# pym2149
YM2149 emulator supporting YM files, OSC to JACK, PortAudio, WAV

## Install
These are generic installation instructions.

### To use, permanently
The quickest way to get started is to install the current release from PyPI:
```
# Tested on Linux and Mac:
pip3 install --user pym2149
```

### To use, temporarily
If you prefer to keep .local clean, install to a virtualenv:
```
python3 -m venv venvname
venvname/bin/pip install -U pip
venvname/bin/pip install pym2149
. venvname/bin/activate
```

## 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.
