eddturtle / turtleplayer

A Free, Fully Fledged, Open-Source Music Player for Android

Turtle Player

Free, Fully Fledged & Open-Source. The Music Player for Android.

Turtle Player is designed to be a fun and unique app for playing your music on the move, while in a advertisment-free app. Originally developed by Edd Turtle, it is now a community driven app with help from developers (namely Simon Honegger) on Github. Give it a go today!

Warning! Due to other commitments I haven't had the time to maintain and keep this project up-to-date. It should work fine on modern android phones, but the visuals and code are bit old - that's all.

How to Contribute

1. First, pull the source code from this git repository to your local machine:

   git clone [email protected]:eddturtle/TurtlePlayer.git cd TurtlePlayer

2. Initialise the submodule dependency for mp3agic.

   git submodule update --init

3. Copy the mp3agic source folder (inside mp3agic/src/main/java/com/mpatric) into the Turtle Player src/com folder.

4. Import the project in Eclipse (or your chosen Android IDE).

5. Make super-awesome improvements...

6. Create a Pull Request back to this repository.

License

Source is licenced under the MIT & GPL.

turtleplayer's Issues

Ability to play music while Library is in Sync

This causes:
a) the potential for playing of non existent music
b) a thread issue shortly after

Toast messages should be more informative.

A description should be given as to what tracks are added to and from on press&hold.

genre icon file chooser

not active icon is the 24 icon instead of 48

Using Maven ?

I like to use maven for the project setup. That allows to keep same project definitions for different IDEs and avoid copying large libs into the repo.

Do you have some experiances ? I 've enougth experiences but i dont want to impose you something. It takes a bit to get used to it...

Oppinions ?

prev button does shuffle

prev button should go to prev track in order (analog next)

replace track with folder navigation in file chooser

for a big music lib the track mode in file chooser is usable but not userfriendly.

replace it with folder navigation should be better. normally a big music lib is divided in folders. if not, behaviour is the same as now

translation into another lang

at least one language should be added to enforce usage of i18, proof of concept...

Code style

I think we have to make some arrangement about coding style (merging is shitty otherwise), specially:

• tabs or space (when spaces, how mutch)
• max line length

In general i think the sun (resp. oracle) standards are a good start. (http://www.oracle.com/technetwork/java/javase/documentation/codeconvtoc-136057.html)

my prefs:

• tabs or space --> space (3)
• max line length --> (100-120)

And please, lower case mehod names ;-)

False Track information

Sometimes track information is wrong on albumart view. Gets ok when sliding, so i think it's a UI update problem. But it is reproducable by prev/next. After sliding, info is ok, prev next and the info is wrong again until sliding.

Can be a problem with a not expected termination of the player.

Build failed AIDE

Unable to build with AIDE; it shows 8 errors.
Several methods are applicable to

Genre Label Font

In Playlist view, Genre should be in the Londrina Solid font for conformities sake.

http://www.google.com/webfonts/specimen/Londrina+Solid

fs scan performance issues

fs scan blocks the player after some time. the thread should be executed with a lower priority.
possible that this is only an issue if the phone is not connected to power, hadnt this issue before when the phone was on cable.

ID3Tag encoding - Æ not correctly decoded

Perhaps its possible to change / define a better encoding in mp3agic. Not verified yet. (de we use UTF-8 ?)

jack unplug handling

music should stop if headphones gets unplugged

Is Shuffle in Settings now depreciated?

Is the shuffle track in the settings view now no longer needed?

Same for the repeat checkbox.

Player does not respect .nomedia

I had a directory containing audio files and a .nomedia. However, the files in this directory were indexed anyway.

Scans for Music on Launch

On each launch it scans the SD card, even though data is stored in DB.

Can't have different files with the same ID3

An email from Bernhard:

"Recently I've tried Turtle Player for Android and it's a nice app.

But one thing I dislike, figured out after some tests.

If there are TWO (different) files with (maybe) different filenames, but using the same interpret and song-title in the ID3-tag, only the first is used.

So for example, if one interpret has the same song (maybe even played differently) on some albums, it's shown only in the first one.

I hope you understand what I mean.
Would be nice to have this fixed.

Thanks,

Bernhard"

Folder art detection

I think folder art should be more general. something like
1.) folder,jpg
2.) front*
3.) *.jpg
4.) *.[anyPicExtension]
5.) traverse all parent folder until mediaPath, with same crits

Swipe Folder Left/Right Forgets Time

Swiping album covers left and right moves track title and album but forgets the time, leaving it in the same place.

choose another track should remove instant filter

or adapt the filter to the selected track

Metadata retrival

ive a problem that i get (with most songs) some rubbish afer the title, album etc.

e.g. metaDataReader.extractMetadata(MediaMetadataRetriever.METADATA_KEY_TITLE); return that like this....

like: Grotesksong�� �����굘ꎟ豔 ����

i found nothing on the net. Anyone has the same problem ?

More feature requests

-- way to show track number (10 of 25 or whatever)
-- Automatic rescan when files have changed, and use the Android MediaStore to determine when files have changed so you don't need to rescan every file on the device

Usage hints

because some functionalities are not easy to guess it whould be good to have a possibility to spawn usage hints once per installation.

dev note:
static method with param msg key. shows modal popup, saves key in preferences

Add resume feature

It would be nice to have a feature where you can resume a track (at the same point) if you exit the app when playing a track.

This is especially useful for a long podcast or audio drama.

Album art goes offscreen

When the album art is shown, it is expanded to fill the screen even if that means the sides go off screen. It would make more sense to try to fit the album art into the area so that it fits in the screen but doesn't go off screen.

Turtle won't load mp3s from Nexus 5 sdcard

Can't seem to read the sdcard on my Nexus 5 (of course, there is no real sdcard). I'm running stock AOSP 4.4.2 (Rastacat "Vanilla", to be precise).

Turtle Player seems to install correctly, but can't seem to find mp3s ("No MP3s found on SDCard"). The app's default library search path, when initially run, is:

/storage/emulated/0/

When searching for music using the application's file location browser it can't access the folder "/sdcard/" or "/mnt/sdcard/". The browser displays those folders along with others in the tree, but when I tap them I get an audible click without entering the folder. I am able to enter other folders OK, just not anything related to "sdcard".

I am able to view files under /mnt/sdcard/ and /sdcard/ using other apps on the Nexus 5. It's just this app that giving fits.

Should Shuffle & Repeat be On/Off by Default?

Simpy a matter of preference, should shuffle and/or repeat be on my default?