Skip to content

Latest commit

 

History

History
94 lines (71 loc) · 3.66 KB

README.md

File metadata and controls

94 lines (71 loc) · 3.66 KB
Raw

Vanilla Music

Vanilla Music player is a GPLv3 licensed MP3/OGG/FLAC/PCM player for Android with the following features:

  • multiple playlist support
  • grouping by artist, album or genre
  • plain filesystem browsing
  • ReplayGain support
  • headset/Bluetooth controls
  • accelerometer/shake control
  • cover art support
  • Simple Last.fm Scrobbler support

Get it on F-Droid

Plugins

Vanilla Music also includes support for plugins, this is a list of some existing plugins:

Donations

You can donate to Vanilla Musics development via gratipay or Bitcoin

Support via Gratipay

Bitcoin: 1adrianERDJusC4c8whyT81zAuiENEqub

Community

Come over and join us on our subreddit /r/VanillaMusic to hangout with fellow Vanilla Music users, ask questions, or help others by answering their questions!

Contributing

Translating

You can help translate here. If your language isn't on the list, sign in to transifex and request the language to be added to the list of translations. (Feel free to open a bug if your request was not approved within a few days - i don't look into transifex that often.)

Contributing code

  • A list of open issues can be found at the issue tracker
  • Features we would like to see (but nobody started working on them yet) have the patches-welcome label attached to them. Please let us know if you start working on such an open issue (to avoid duplicate work)
  • We accept raw patches and github pull request - and we use tabs.

Building

To build you will need:

  • A Java compiler compatible with Java 1.7
  • The Android SDK with platform 24 (Nougat) installed

Building from command-line #1

  • gradle build to build the APK
  • Optional: gradle installDebug to install the APK to a connected device

Building from command-line #2

  • android update project --path . to generate local.properties
  • ant debug to build the APK at bin/VanillaMusic-debug.apk
  • Optional: ant installd to install the APK to a connected device

Building with Android Studio

You can also build with Android Studio by importing this project into it.

Building from Eclipse

You can also build from Eclipse. Create a new Android Project, choosing "Create project from exisiting source", then set the compiler compliance level to 1.6 in project settings.

Nightly Builds

Automatically created builds are available from http://android.eqmx.net/android/vanilla/VanillaMusic-nightly.apk

Documentation

Javadocs can be generated using gradle javadoc or ant doc