Skip to content

michioxd/nyantracker

Repository files navigation

nyantracker player

GitHub License GitHub Actions Workflow Status Website

A simple web-based player for chiptune music modules or music tracker, built with WebAssembly and TypeScript. It supports various module formats and provides a user-friendly interface for playback and navigation. Using DrSnuggles's chiptune3 for playback (via AudioWorklet) and libopenmpt (WASM) for pattern viewer.

screenshot

Features

  • Support for various module formats (e.g., MOD, XM, S3M, IT)
  • Pattern viewer for visualizing the music structure
  • Oscilloscope for visualizing each channel's output
  • Support multiple sources (local files, modland.com, etc.). You can create your own source by implementing the BrowserSource interface.
  • Support multiple color themes.

Development

You must have the latest version of bun. If not, please install it first.

git clone https://github.com/michioxd/nyantracker.git
cd nyantracker
bun i
bun dev

Then open http://localhost:5173 in your browser to see the player in action.

To build the project, run:

bun run build

Contributing

Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request. Please make sure to follow the existing code style and include tests for any new features or bug fixes.

AI-generated (or vibe-coded) contributions are not accepted at this time.

License

This project is licensed under the MIT License. See the LICENSE file for details.