LimePlayer3DS: Difference between revisions

LimePlayer3DS
LimePlayer3DS
General
Author	Oreo639
Type	Media Players
Version	0.0.10
License	GPL-3.0
Last Updated	2021/05/15
Links
	Download
	Website
	Source

Latest revision as of 06:26, 6 May 2024

LimePlayer3DS is a graphical music player for the 3DS with metadata parsing and software midi support.

Features

GUI music player.
Supports MIDI.
Internet Radio (mp3 and opus streams).
Multi-languages.

Installation

Available as 3DSX.

It checks for music in the sdmc:/music folder. If it doesn’t exist then it just goes to sdmc:/, just like ctrmus.

User guide

Supported formats

MP3, WAV, FLAC, MIDI, XMI, MUS, HMI, HMP, Ogg Vorbis and Opus.

Configuration

The default path for midi patchsets is /3ds/limeplayer3ds/8mbgmpat/.

This path be changed in the config file located at /3ds/limeplayer3ds/config.json which should be created (if it doesn’t already exist) upon launching the application.

See here for more info about LimePlayer3DS’s config.json.

For more information on usage of the various features LimePlayer offers, please refer to the official wiki page.

Controls

Select - Enter quick menu

Start - Exit application

A - Select/Play/Change directory

B - Go back

X+Y - Exit Playback

X+A - Skip to next song

X+Up - Pause/Play

X+Right - Seek forward

X+Left - Seek backward

L/R - Switch windows (browser and player controls)

Screenshots

Changelog

v0.0.10 2021/05/15

Added touch screen buttons for switching between browser and controls.
Removed unused icons from quick menu.
Made control window buttons clickable.
Fixed bug where playback would not quit after skipping last song in playlist.

Release notes.

Credits

Deltabeard - For his work on ctrmus which was the original foundation for this application as LimePlayer3DS initally started out as a fork of ctrmus.
devkitPro - For providing amazing, easy to use, toolchains that without, this application would have never existed.
Astronautlevel & LiquidFernir (and the Anemone3DS team) - For their work on Anemone3DS which helped quite a bit when it came to starting with citro2d graphics, and they were very helpful in general.
Flagbrew - The GUI code is heavilly based on PKSM’s GUI code.
Most of the icons under gfx are from the site icons8.com and are licensed under the CC-BY-NC-SA

Special Thanks:

The Easyrpg Team - For inspiring this application.
smealum, fincs, WinterMute, and devkitPro contributors - For making/maintaining documentation and examples for libctru and citro2d/3d which is incredibly helpfull when working on this project.
Testers - For testing, providing feedback, and reporting bugs.

External links

Official website - https://github.com/Oreo639/LimePlayer3DS/wiki
GitHub - https://github.com/Oreo639/LimePlayer3DS

@@ Line 1: / Line 1: @@
-{{Infobox-3DS-Homebrews
+{{Infobox 3DS Homebrews
-| title = LimePlayer3DS
+|title=LimePlayer3DS
-| image = https://dlhb.gamebrew.org/3dshomebrew/LimePlayer3DS-01.png|250px
+|image=LimePlayer3DS-01.png
-| type = Media players
+|description=GUI music player for the Nintendo 3DS (WIP).
-| version = v0.0.10
+|author=Oreo639
-| lastupdated = 2021/05/15
+|lastupdated=2021/05/15
-| licence = Mixed
+|type=Media Players
-| author = Oreo639
+|version=0.0.10
-| website = https://github.com/Oreo639/LimePlayer3DS/wiki
+|license=GPL-3.0
-| download = https://dlhb.gamebrew.org/3dshomebrew/LimePlayer3DS.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/limeplayer3ds.7z
-| source = https://github.com/Oreo639/LimePlayer3DS
+|website=https://github.com/Oreo639/LimePlayer3DS/wiki
+|source=https://github.com/Oreo639/LimePlayer3DS
 }}
-LimePlayer3DS is a graphical music player for the 3ds with metadata parsing and software midi support.
+LimePlayer3DS is a graphical music player for the 3DS with metadata parsing and software midi support.
-It checks for music in the <code>sdmc:/music</code> folder. If it doesn’t exist then it just goes to <code>sdmc:/</code>, just like ctrmus.
+==Features==
+* GUI music player.
+* Supports MIDI.
+* Internet Radio (mp3 and opus streams).
+* Multi-languages.
-The default path for midi patchsets is <code>/3ds/limeplayer3ds/8mbgmpat/</code>.
+==Installation==
+Available as 3DSX.
-This path be changed in the config file located at <code>/3ds/limeplayer3ds/config.json</code> which should be created (if it doesn’t already exist) upon launching the application.
+It checks for music in the <code>sdmc:/music</code> folder. If it doesn’t exist then it just goes to <code>sdmc:/</code>, just like [[Ctrmus_3DS|ctrmus]].
-More info about LimePlayer3DS’s config.json can be found here: <br/> https://github.com/Oreo639/LimePlayer3DS/wiki/config.json
+==User guide==
+===Supported formats===
+MP3, WAV, FLAC, MIDI, XMI, MUS, HMI, HMP, Ogg Vorbis and Opus.
-[https://github.com/Oreo639/LimePlayer3DS/wiki For more information on usage of the various features LimePlayer offers, check here.]
+===Configuration===
+The default path for midi patchsets is <code>/3ds/limeplayer3ds/8mbgmpat/</code>.
-==Screenshots==
+This path be changed in the config file located at <code>/3ds/limeplayer3ds/config.json</code> which should be created (if it doesn’t already exist) upon launching the application.
-https://dlhb.gamebrew.org/3dshomebrew/LimePlayer3DS-01.png
-https://dlhb.gamebrew.org/3dshomebrew/LimePlayer3DS-02.png
-https://dlhb.gamebrew.org/3dshomebrew/LimePlayer3DS-03.png
-== Note ==
+See [https://github.com/Oreo639/LimePlayer3DS/wiki/config.json here] for more info about LimePlayer3DS’s config.json.
-LimePlayer3DS is currently in alpha so not all features are going to be available.
+For more information on usage of the various features LimePlayer offers, please refer to the [https://github.com/Oreo639/LimePlayer3DS/wiki official wiki page].
-== Officaly Supported Formats ==
+==Controls==
+Select - Enter quick menu
-Mp3, Wav, Flac, Midi, Xmi, Mus, Hmi, Hmp, Ogg vorbis, and Opus.
+Start - Exit application
-== Building ==
+A - Select/Play/Change directory
-=== Prerequsites: ===
+B - Go back
-[https://devkitpro.org/wiki/devkitPro_pacman dkp-pacman]
+X+Y - Exit Playback
-ds-dev 3ds-mpg123 3ds-libvorbisidec 3ds-opusfile 3ds-flac 3ds-wildmidi 3ds-jansson 3ds-pkg-config
+X+A - Skip to next song
-You may also need [https://github.com/profi200/Project_CTR makerom] and [https://github.com/Steveice10/bannertool/ bannertool] for cia building (optional).
+X+Up - Pause/Play
-=== Compiling: ===
+X+Right - Seek forward
-Once you complete Prerequsites, run <code>make</code> or <code>make &lt;target&gt;</code>. Replace <code>&lt;target&gt;</code> with one of the targets listed below
+X+Left - Seek backward
-=== Targets: ===
+L/R - Switch windows (browser and player controls)
-* 3dsx (3dsx only build)
+==Screenshots==
-* cia (generate cia, 3dsx must be built first)
+https://dlhb.gamebrew.org/3dshomebrews/limeplayer3ds2.png
-* clean (clean compiled files)
+https://dlhb.gamebrew.org/3dshomebrews/limeplayer3ds3.png
-If you want to build with compiler optimazitions, just add RELEASE=1 to the end (EX: <code>make 3dsx RELEASE=1</code>)
+==Changelog==
+'''v0.0.10 2021/05/15'''
+* Added touch screen buttons for switching between browser and controls.
+* Removed unused icons from quick menu.
+* Made control window buttons clickable.
+* Fixed bug where playback would not quit after skipping last song in playlist.
-== Credits ==
+[https://github.com/Oreo639/LimePlayer3DS/releases Release notes.]
-* Deltabeard: For his work on ctrmus which was the original foundation for this application as LimePlayer3DS initally started out as a fork of ctrmus.
+==Credits==
-* devkitPro: For providing amazing, easy to use, toolchains that without, this application would have never existed.
+* Deltabeard - For his work on ctrmus which was the original foundation for this application as LimePlayer3DS initally started out as a fork of ctrmus.
-* Astronautlevel &amp; LiquidFernir (and the Anemone3DS team): For their work on Anemone3DS which helped quite a bit when it came to starting with citro2d graphics, and they were very helpful in general.
+* devkitPro - For providing amazing, easy to use, toolchains that without, this application would have never existed.
-* Flagbrew: The GUI code is heavilly based on PKSM’s GUI code.
+* Astronautlevel & LiquidFernir (and the Anemone3DS team) - For their work on Anemone3DS which helped quite a bit when it came to starting with citro2d graphics, and they were very helpful in general.
-* Others: If I forgot to mention someone important (for example: your code is used without credit), please let me know.
+* Flagbrew - The GUI code is heavilly based on PKSM’s GUI code.
 * Most of the icons under gfx are from the site [https://icons8.com icons8.com] and are licensed under the [https://creativecommons.org/licenses/by-nc-sa/3.0/ CC-BY-NC-SA]
-== Special Thanks ==
+Special Thanks:
+* The Easyrpg Team - For inspiring this application.
-* The Easyrpg Team: For inspiring this application.
+* smealum, fincs, WinterMute, and devkitPro contributors - For making/maintaining documentation and examples for libctru and citro2d/3d which is incredibly helpfull when working on this project.
-* smealum, fincs, WinterMute, and devkitPro contributors: For making/maintaining documentation and examples for libctru and citro2d/3d which is incredibly helpfull when working on this project.
+* Testers - For testing, providing feedback, and reporting bugs.
-* Testers: For testing, providing feedback, and reporting bugs.
-== Copyright ==
-The application is licensed under the GPLv3-or-later. Additional terms 7c apply.
-You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
-[[Category:3DS homebrew applications]]
+==External links==
-[[Category:Homebrew media players on 3DS]]
+* Official website - https://github.com/Oreo639/LimePlayer3DS/wiki
+* GitHub - https://github.com/Oreo639/LimePlayer3DS