mirror of
https://github.com/playmusicexporter/playmusicexporter
synced 2024-05-06 12:46:42 +00:00
Jan Christian Grünhage
204829ac5b
- Disabled JACK Toolchain, moved to native Java 8 support instead. - Updated gradle plugin from 2.3 to 2.4-alpha6 - Removed the paragraph about bithub from the README - Rephrased some things about why 5.0 is minimum - Made analytics opt-in on first launch - Extracted strings from the intro - Added [LeakCanary](https://github.com/square/leakcanary)
65 lines
3.2 KiB
Markdown
65 lines
3.2 KiB
Markdown
# Play Music Exporter
|
|
|
|
This Android app exports your Play Music mp3 files directly to your sdcard
|
|
or a documents provider using root permissions.
|
|
You can also setup automatic export, that exports all currently cached not yet exported music.
|
|
|
|
[<img src="https://f-droid.org/badge/get-it-on.png"
|
|
alt="Get it on F-Droid"
|
|
height="80">](https://f-droid.org/app/re.jcg.playmusicexporter)
|
|
|
|
## About
|
|
|
|
This AndroidStudio project allow you to access the database from Google's PlayMusic
|
|
and also allows you to export the music files as mp3 to your sdcard or a documents provider.
|
|
There is also a nice library you can simply use in your projects.
|
|
|
|
### Requirements
|
|
|
|
**This app and the included library will require root access to your device!
|
|
If your device is not rooted you can neither use this app nor the library.**
|
|
|
|
This app uses multiple features introduced in API Level 21 (Android 5.0 Lollipop), the JobScheduler
|
|
and the the folder selection of the storage access framework.
|
|
If you use KitKat or lower, this app will not work.
|
|
|
|
### Credits
|
|
|
|
This is a fork off [David Schulte's original project](https://github.com/Arcus92/PlayMusicExporter).
|
|
Most of the work has been done by him, me and the other collaborators just have improved his work
|
|
in some minor ways, like making the app more usable and configurable. The exporting itself, the hard
|
|
part, has been done by him.
|
|
|
|
This project uses the [mp3agic library](https://github.com/mpatric/mp3agic)
|
|
by [Michael Patricios (mpatric)](https://github.com/mpatric).
|
|
|
|
### Contributing
|
|
|
|
#### What can you contribute?
|
|
|
|
Implement features you want to see, or take a look at the issue tracker and fix broken things. Before making bigger changes, see that a contributor is supporting the inclusion, so that you can be sure it will be merged. (See Discuss Ideas below)
|
|
|
|
#### How to contribute:
|
|
|
|
If you want to contribute to this project, fork off of develop,
|
|
implement what you want to implement, and submit a pull request back into develop.
|
|
After testing it, if enough of the collaborators like it, we will merge it.
|
|
You might want to discuss your ideas with us first though:
|
|
|
|
#### Discuss Ideas
|
|
|
|
If you have any questions, the easiest way to get help is asking in the #playmusicexporter IRC channel on freenode. You can join that on webchat.freenode.net, or preferably, if you are not really an IRC guy anyway, try the corresponding matrix room [#playmusicexporter:jcg.re](https://matrix.to/#/#playmusicexporter:jcg.re). They are bridged together, so everything that happens in one of the rooms gets automatically transfered to the other one too.
|
|
|
|
### Supporting this project
|
|
|
|
If you want to support this project, the best way to do so is contributing source code to the project (see above), or help with illustrations, if that is something you're good at! (I am most certainly not good at creating icons and such things)
|
|
|
|
If you are unable to do that, but you still want to support this project, you could send me some bitcoins instead: 1NdzpDWPQ53xWT5fraGPZX5F9XrKiPBXjp
|
|
|
|
I will distribute bitcoins send to me to others helping on the project too, so that other people contributing also have a piece of the cake.
|
|
|
|
### Copyright
|
|
|
|
Copyright (c) 2016 Jan Christian Grünhage. See LICENSE.txt for details.
|
|
Copyright (c) 2015 David Schulte. See LICENSE.txt for details.
|