YMPLAYER(1)

📦 version 0.21a, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 YMPLAYER 💖

okay bestie, gather round, because we're about to talk about the most niche little music player you've ever met, and honestly? she's iconic. this is the manual page for ymplayer, from the User Commands corner of the man-page universe, and i'm gonna walk you through every single crumb of it. no skips, no cuts. periodt. 🎀

✨ NAME ✨

ymplayer — a curses based player for the YM chiptune format. that's it. that's the whole name section. short, sweet, slays. 💅

🌸 DESCRIPTION 🌸

okay so. STYMulator is an Open Source (GPL License) player, and what it does is play music files in the YM chiptune format. and before you ask — yes, that's a real thing, and yes, it's lowkey amazing.

the YM files are, specifically, Yamaha YM2149 soundchip music datas (registers) dumped from the ATARI 16-bit computers. like, literal register dumps of a whole soundchip. the raw vibes, preserved. iykyk. 🔥

ymplayer — which is part of STYMulator, btw, not a separate thing, she's a piece of a bigger era — is a console based player for this format. and the way she pulls it off? she uses ALSA for sound rendering and the ncurses library for her user interface. retro audio, terminal aesthetic. main character energy fr fr. 👑

🦋 SYNOPSIS 🦋

ymplayer <input_ym_music_file>

that's the whole incantation. feed her one file and she goes. ✨

💅 OPTIONS 💅

so here's the thing, and i need you to be seated for this:

ymplayer has no options.

like. zero. none. she is not a "configure me" girl, she is a "just give me the file and let me cook" girl. and honestly? respect.

however — and this is the part that matters — she does require a <input_ym_music_file> argument, which is a relative or absolute path to one YM music file. one. singular. just the one. she's monogamous with her input files, bestie. 🫶

🌈 SEE ALSO 🌈

go check the homepage, it's giving archival treasure. 🧚

👑 AUTHOR 👑

this manual page was written by Adam Cecile <gandalf@le-vert.net> for the Debian system (but may be used by others). generous king behavior honestly.

permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.

and on Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. bookmark it if you're a nerd like me, no judgment. 📚

also quick vibe check: this whole page is describing version 0.21, dated March 2007. a little time capsule. a little relic. and she still hits. 💖

okay that's the whole page, you're fully caught up, go play some chiptunes and text me when you do. mwah. 🎀✨🌸💜

📦 where this page comes from