<p align="center">
  <img src="fastlane/metadata/android/en-US/images/icon.png" width="200">
</p>

<h1 align="center">Satunes (🇬🇧)</h1>
<p align="center">
  <a href="https://github.com/antoinepirlot/Satunes/releases/latest">
    <img src="https://img.shields.io/github/release/antoinepirlot/Satunes.svg?logo=github">
  </a>
</p>
<p align="center">
  <a href="https://f-droid.org/app/io.github.antoinepirlot.satunes"><img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" width="200"></a>
</p>

Vous pouvez retrouver ce fichier en [français 🇫🇷](README.md)

Satunes is a mp3 player on Android. Use it to listen your music from your audio files stored in your
Android phone (Android Lollipop 5.1.1 and later).

This entire project is under GNU/GPL v3 and it's applied on all version of this project (even the
code pushed from the very first commit.).

If you decide to use my code to create new app, you can but you have to use the same license :p

# Screenshots

<p>
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/5.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/6.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/7.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/8.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/9.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/10.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/11.png" width = "200">
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/12.png" width = "200">
</p>

# Features

* Play music on phone
* View artists and their albums and music
* View genres and their albums and music
* Custom playlists
* Play music based on folders, albums, genres, artists and playlists
* Export and import playlists (beta)
* Personalization of the experience:
    * Stop or continue playing music if the app is closed
    * Pause or not if:
        * another app plays another audio
        * Headphones are unplugged (bluetooth and cable)
    * Choice of progress bar refresh speed
    * Choice of default playback modes
* Exclude ringtones or not
* Update the application without leaving it

# Installation

To install easily, you can download the application from Fdroid by clicking on the button below.
<p align="center">
  <a href="https://f-droid.org/app/io.github.antoinepirlot.satunes"><img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" width="150"></a>
</p>

Otherwise, you can also follow the following steps:

## Application

1) Click on [Release](https://github.com/antoinepirlot/Satunes/releases)
2) Choose your version
3) Click on "Assets" to deploy a menu that contains the installation file.
4) Click on the file Satunes_vx.y.z.apk (A file will be downloaded on your device).
5) Once the file is downaloded, open it.
6) Allow the unknwon application installation (It's required as the app is not deployed on the Play
   Store).
7) Install the app (it is likely that you will have to start step 5 again).
9) I recommand you to disable unknown app installation for the app from where you installed the app.
10) Enjoy you music freely :D

## Android Auto

1) Go to Android Auto settings.
2) Multiple click on "Version" to activate dev mode.
3) Go to Dev's settings and activate "Unknown sources" as this app is not published on Google Play
   Store.
4) Click on the 3 buttons as in point 3, but click on "Exit developer mode" the setting you just
   activated will be saved.
5) Add app in launcher.
6) Enjoy

##

If you like the app and want to support me click [here](https://tipeee.com/antoinepirlot).

# Releases

If you want to know about different releases and what they added, [click here.](RELEASES_EN.md)
