Pym2149: Difference between revisions

From YM2149.org
Jump to navigationJump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 17: Line 17:
== Install ==
== Install ==


This section is out of date, please see github first.
* Follow instructions at https://pypi.org/project/pym2149/
hg clone https://combatopera@bitbucket.org/combatopera/pym2149
cd pym2149
* To avoid ruining the system python installation, we're going to build a dedicated python environment
* <code>./drone.io.sh</code>
** This will automatically download the pyrbo and pyven projects next to pym2149, download and configure Miniconda (a free scientific python distribution) next to pym2149, and run the tests
* YM files typically come compressed, and pym2149 requires <code>lha</code> to automatically unpack them
* YM files typically come compressed, and pym2149 requires <code>lha</code> to automatically unpack them
** Debian/Ubuntu package: <code>lha</code> or <code>lhasa</code>
** Debian/Ubuntu package: <code>lha</code> or <code>lhasa</code>
** Windows: http://gnuwin32.sourceforge.net/packages/lha.htm and add its folder to your <code>PATH</code>
** Windows: http://gnuwin32.sourceforge.net/packages/lha.htm and add its folder to your <code>PATH</code>
* For JACK output you'll need jackd running, I use qjackctl to manage it
* For JACK output you'll need jackd running, I use qjackctl to manage it
* For MIDI support see [[MIDI]]


== Play ==
== Play ==
Line 33: Line 27:
* You can get some ZIPs of YM files from http://pacidemo.planet-d.net/aldn/
* You can get some ZIPs of YM files from http://pacidemo.planet-d.net/aldn/
** Barry Leitch is a good start
** Barry Leitch is a good start
* Now the <code>ym2wav.py</code> script can convert a YM file to WAV
* Now the <code>ym2wav</code> script can convert a YM file to WAV
** e.g. <code>./ym2wav.py 'Utopia 1.ym' out.wav</code> or just <code>./ym2wav.py 'Utopia 1.ym' - | aplay</code>
** e.g. <code>ym2wav 'Utopia 1.ym' out.wav</code> or just <code>ym2wav 'Utopia 1.ym' - | aplay</code>
* To play via JACK ensure jackd is running (I use <code>qjackctl -s</code>) and then <code>./ym2jack.py 'Utopia 1.ym'</code>
* To play via JACK ensure jackd is running (I use <code>qjackctl -s</code>) and then <code>ym2jack 'Utopia 1.ym'</code>
* Bluetooth output is available via PulseAudio by using the PortAudio scripts e.g. <code>ym2portaudio</code>


{{Dev|pym2149}}
{{Dev|pym2149}}


[[Category:Software]]
[[Category:Software]]

Latest revision as of 21:44, 22 February 2025

YM2149 emulator in Python, NumPy and a little Cython where it matters. The aims of this project are to demonstrate it can be done in Python, accurate emulation, and interoperability with existing tools. Unlike other projects, we don't emulate the rest of the Atari ST.

System requirements

  • Linux is the only tested platform
  • JACK Audio Connection Kit for real-time rendering

Install

Play

  • You can get some ZIPs of YM files from http://pacidemo.planet-d.net/aldn/
    • Barry Leitch is a good start
  • Now the ym2wav script can convert a YM file to WAV
    • e.g. ym2wav 'Utopia 1.ym' out.wav or just ym2wav 'Utopia 1.ym' - | aplay
  • To play via JACK ensure jackd is running (I use qjackctl -s) and then ym2jack 'Utopia 1.ym'
  • Bluetooth output is available via PulseAudio by using the PortAudio scripts e.g. ym2portaudio

Dev