Tangerine 3DS: Difference between revisions

Tangerine
Tangerine
General
Author	tesnos
Type	Media Players
Version	0.1.0
License	Mixed
Last Updated	2018/01/21
Links
	Download
	Website
	Source

Latest revision as of 06:26, 6 Mayıs 2024

Tangerine is a work-in-progress music player for the Nintendo 3DS and Nintendo Switch.

Note from developer:

The 3DS build is currently in heavy development as the shift is made from pp2d to citro2d. Please use the previous build instead of building yourself.

Features

Support for multiple formats (wav, flac, and mp3 currently).
Ability to play playlists.
Anything else the 3DS's sound application does.
Touchscreen controls.

Installation

Installing

Available in 3DSX/SMDH and CIA formats.

Building

You can just run make or make all to get both 3DS and Switch builds, but for just one of them follow this.

3DS:

Install the latest releases of ctrulib, citro3d, citro2d, and 3ds-mpg123 via the devkitPro pacman.

Then type make 3ds to get a .3dsx, .smdh, and .cia.

Switch:

Install the latest releases of libnx and switch-mpg123 installed via the devkitPro pacman.

Then type make switch to get a .nro.

User guide

Put all music in /music/ folder on your SD card as traditional file browsing is not currently supported yet.

Controls

L/R - Skip forward/back a song

A - Pause/play

B - Return to file selection

Progress bar (touch screen) - Scrub through the audio (slow)

Known issues

Some flac files have issues with playback speed on hardware but work fine in Citra.

Scrubbing within flac/mp3 files may take several seconds on Old 3DS depending on the size of the file

Credits

Thanks to:

@smealum for ctrulib.
@fincs for citro3d.
@Steveice10 for buildtools.
@BernardoGiordano for pp2d and help with Makefile/rsf files.
VLC for android for the rough UI design concept.
@Sergey#5402 for help testing.
@Fenrir#3268, @ahoischen#9453, and @TurtleP#2954 (and anyone else!) in #dev in the Nintendo Homebrew discord for help with some beginner C mistakes.
mackron for their doctor libs (dr_flac and dr_wav specifically).
devkitPro for the example Makefiles, portlibs, and citro2d.
switchbrew/3dsbrew for documentation and examples.
The big N for the Nintendo 3DS Sound application.
Erokia for Heartbleed Synth.
and @deltabeard for their orginal libmpg123 portlib fork and ctrmus (big inspiration and for understanding the DSP a lot better).

External links

GitHub - https://github.com/tesnos/tangerine

@@ Line 1: / Line 1: @@
-{{Infobox 3DS homebrew
+{{Infobox 3DS Homebrews
-| title = Tangerine
+|title=Tangerine
-| image = https://dlhb.gamebrew.org/3dshomebrew/|250px
+|image=Tangerine2.png
-| type = Media players
+|description=A music player for 3DS and Nintendo Switch (WIP).
-| version = v0.1.0
+|author=tesnos
-| licence = Mixed
+|lastupdated=2018/01/21
-| author = tesnos
+|type=Media Players
-| website = https://github.com/tesnos/tangerine
+|version=0.1.0
-| download = https://dlhb.gamebrew.org/3dshomebrew/Tangerine-3DS.rar
+|license=Mixed
-| source = https://dlhb.gamebrew.org/3dshomebrew/Tangerine-3DS.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/tangerine.7z
+|website=https://github.com/tesnos/tangerine
+|source=https://github.com/tesnos/tangerine
 }}
-<youtube></youtube>
+Tangerine is a work-in-progress music player for the Nintendo 3DS and Nintendo Switch.
-<img src="https://github.com/tesnos/tangerine/raw/master/meta/logo.png" alt="tangerine logo">
+'''Note from developer:'''
-# tangerine
-### A work-in-progress music player for the Nintendo 3DS and Nintendo Switch
+The 3DS build is currently in heavy development as the shift is made from pp2d to citro2d. Please use the previous build instead of building yourself.
-## Overview:
-- The 3DS build is currently in heavy development as the shift is made from pp2d to citro2d. Please use the previous build instead of building yourself.
+==Features==
-- Put all music in "/music" folder on your SD card as traditional file browsing is not currently supported yet
+* Support for multiple formats (wav, flac, and mp3 currently).
-- Support for multiple formats (wav, flac, and mp3 currently)
+* Ability to play playlists.
-- Skip forward and back a song using the L and R buttons
+* Anything else the 3DS's sound application does.
-- Use the progress bar on the touch screen to scrub through the audio (SLOW)
+* Touchscreen controls.
-- Pause/Play with A, and return to file selection with B
-- *Touchscreen* controls (yay?)
+==Installation==
-## Planned Features:
+===Installing===
-- [ ] Update internal documentation
+Available in 3DSX/SMDH and CIA formats.
-- [ ] Move to citro2d
-- [ ] Switch version
+===Building===
-- [ ] Actual file browsing
+You can just run <code>make</code> or <code>make all</code> to get both 3DS and Switch builds, but for just one of them follow this.
-- [ ] Support for more formats
-- [ ] Ability to create playlists
+'''3DS:'''
-- [x] Ability to play playlists
-- [ ] Record and save bits of audio using the microphone like the built in app
+Install the latest releases of ctrulib, citro3d, citro2d, and 3ds-mpg123 via the devkitPro pacman.
-- [ ] UI overhaul (currently it's not super terrible, but it's definitely not where I want it to be)
-- [ ] Themes maybe?
+Then type <code>make 3ds</code> to get a .3dsx, .smdh, and .cia.
-+ anything else the 3DS's sound application does
-## Building
+'''Switch:'''
-You can just run `make` or `make all` to get both 3ds and switch builds, but for just one of them follow this:
-### 3DS
+Install the latest releases of libnx and switch-mpg123 installed via the devkitPro pacman.
-Make sure you have the latest releases of ctrulib, citro3d, citro2d, and 3ds-mpg123 installed via the devkitPro pacman. Then type
-```
+Then type <code>make switch</code> to get a .nro.
-make 3ds
-```
+==User guide==
-to get a .3dsx, .smdh, and .cia
+Put all music in /music/ folder on your SD card as traditional file browsing is not currently supported yet.
-### Switch
-Make sure you have the latest releases of libnx and switch-mpg123 installed via the devkitPro pacman. Then type
+==Controls==
-```
+L/R - Skip forward/back a song
-make switch
-```
+A - Pause/play
-to get an .nro
-## Known Issues:
+B - Return to file selection
-- Some flac files have issues with playback speed on hardware but work fine in Citra
-- Scrubbing within flac/mp3 files may take several seconds on Old 3DS depending on the size of the file
+Progress bar (touch screen) - Scrub through the audio (slow)
-WARNING: This was my first time ever writing C. There are going to be bugs and 90% percent of this is probably terrible code, so don't hesitate to report anything because I probably wouldn't have found it otherwise.
-## Credits:
+==Known issues==
-Thanks to
+Some flac files have issues with playback speed on hardware but work fine in Citra.
-- @smealum for [ctrulib](https://github.com/smealum/ctrulib)
-- @fincs for [citro3d](https://github.com/fincs/citro3d)
+Scrubbing within flac/mp3 files may take several seconds on Old 3DS depending on the size of the file
-- @Steveice10 for [buildtools](https://github.com/Steveice10/buildtools)
-- @BernardoGiordano for [pp2d](https://github.com/BernardoGiordano/Checkpoint/tree/master/source/pp2d) and help with Makefile/rsf files
+==Credits==
-- [VLC for android](https://www.videolan.org/vlc/download-android.html) for the rough UI design concept
+Thanks to:
-- @Sergey#5402 for help testing
+* @smealum for [https://github.com/smealum/ctrulib ctrulib].
-- @Fenrir#3268, @ahoischen#9453, and @TurtleP#2954 (and anyone else!) in #dev in the Nintendo Homebrew discord for help with my beginner C mistakes
+* @fincs for [https://github.com/fincs/citro3d citro3d].
-- [mackron](https://mackron.github.io/) for their [doctor libs](https://github.com/mackron/dr_libs) (dr_flac and dr_wav specifically)
+* @Steveice10 for [https://github.com/Steveice10/buildtools buildtools].
-- devkitPro for the example Makefiles, portlibs, and [citro2d](https://github.com/devkitPro/citro2d)
+* @BernardoGiordano for [https://github.com/BernardoGiordano/Checkpoint/tree/master/source/pp2d pp2d] and help with Makefile/rsf files.
-- switchbrew/3dsbrew for documentation and examples
+* [https://www.videolan.org/vlc/download-android.html VLC for android] for the rough UI design concept.
-- The big N for the Nintendo 3DS Sound application
+* @Sergey#5402 for help testing.
-- [Erokia](https://freesound.org/people/Erokia) for ["Heartbleed Synth"](https://freesound.org/people/Erokia/sounds/414770/)
+* @Fenrir#3268, @ahoischen#9453, and @TurtleP#2954 (and anyone else!) in #dev in the Nintendo Homebrew discord for help with some beginner C mistakes.
-- and @deltabeard for their orginal libmpg123 portlib fork and [ctrmus](https://github.com/deltabeard/ctrmus) (big inspiration, helped me to understand the DSP a lot better)
+* [https://mackron.github.io/ mackron] for their [https://github.com/mackron/dr_libs doctor libs] (dr_flac and dr_wav specifically).
-## Licensing Information:
+* devkitPro for the example Makefiles, portlibs, and [https://github.com/devkitPro/citro2d citro2d].
-See LICENSE.md
+* switchbrew/3dsbrew for documentation and examples.
+* The big N for the Nintendo 3DS Sound application.
+* [https://freesound.org/people/Erokia Erokia] for [https://freesound.org/people/Erokia/sounds/414770/ Heartbleed Synth].
+* and @deltabeard for their orginal libmpg123 portlib fork and [https://github.com/deltabeard/ctrmus ctrmus] (big inspiration and for understanding the DSP a lot better).
+==External links==
+* GitHub - https://github.com/tesnos/tangerine