https://github.com/deltabeard/ctrmus
3DS Music Player
https://github.com/deltabeard/ctrmus
c homebrew music-player nintendo-3ds
Last synced: 5 months ago
JSON representation
3DS Music Player
- Host: GitHub
- URL: https://github.com/deltabeard/ctrmus
- Owner: deltabeard
- License: gpl-3.0
- Created: 2016-10-23T18:40:55.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-10-22T15:23:21.000Z (8 months ago)
- Last Synced: 2025-10-22T17:30:03.629Z (8 months ago)
- Topics: c, homebrew, music-player, nintendo-3ds
- Language: C
- Size: 3.89 MB
- Stars: 120
- Watchers: 13
- Forks: 17
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ctrmus: a music player for the Nintendo 3DS
The latest 3DSX/CIA/3DS download can be found on the releases page, or by scanning this QR code.
## Features
* Plays PCM WAV, AIFF, FLAC, Opus, Vorbis and MP3 files.
* Pause and play support.
* Plays music via headphones whilst system is closed.
* Ability to browse directories.
## Controls
L+R or L+Up: Pause
ZL/ZR or L/R: Previous/Next Song
L+Left: Show Controls
A: Play file or change to selected directory
B: Go up folder
Up & down = Move cursor
Left & right = Move cursor skipping 13 files at a time.
Start: Exit
# Contributing
I very much welcome a pull request from anyone wanting to contribute! Be it a small spelling mistake, a bug fix or otherwise.
## Adding features
Create an issue before you start work so that others know that your considering working on adding a feature or fixing a bug.
## Pull requests
Please consider the following when making a pull request.
* Commit messages should be clear.
* Code style should be consistent.
If you're unsure whether to make a pull request, just make it. :smiley:
## Compiling
Build dependencies:
- GNU Make
- [makerom](https://github.com/3DSGuy/Project_CTR)
- [bannertool](https://github.com/Steveice10/bannertool)
- [devkitARM](https://devkitpro.org/wiki/Getting_Started), with the following packages installed:
- 3ds-libogg
- 3ds-libopus
- 3ds-libsidplay
- 3ds-libvorbisidec
- 3ds-mpg123
- 3ds-opusfile
- libctru
Installing packages in MSYS2:
```
pacman -S libctru 3ds-mpg123 3ds-libopus 3ds-opusfile 3ds-libogg 3ds-libvorbisidec 3ds-libsidplay
```
Make sure to put `C:\devkitPro\tools\bin` on your PATH.
To build, type `make` in the project folder.
### Planned features
* Playlist support.
* Repeat and shuffle support.
* Metadata support.
#### Notes
Due to limitations in [ctrulib](https://github.com/smealum/ctrulib/issues/328), only ASCII characters are displayed correctly. Other characters will appear garbled, but functionality is not affected.
[Ctrulib](https://github.com/smealum/ctrulib/issues/328)の制約でアスキー文字のみ正しく表示されます。それ以外の文字エンコードの場合文字化けはしますが、機能自体に影響はありません。
Banner music uses a modified version of ["Rad Adventure" by Scott Holmes](http://freemusicarchive.org/music/Scott_Holmes/).