Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/simple-last-fm-scrobbler/sls

Simple Scrobbler, for Android -- last.fm, libre.fm & ListenBrainz
https://github.com/simple-last-fm-scrobbler/sls
android caching-scrobbles fm-scrobbler java libre listenbrainz music-apps scrobbler sls
Last synced: 2 months ago
JSON representation
Simple Scrobbler, for Android -- last.fm, libre.fm & ListenBrainz
Host: GitHub
URL: https://github.com/simple-last-fm-scrobbler/sls
Owner: simple-last-fm-scrobbler
License: apache-2.0
Archived: true
Created: 2012-02-06T20:55:06.000Z (almost 13 years ago)
Default Branch: master
Last Pushed: 2021-06-28T07:41:22.000Z (over 3 years ago)
Last Synced: 2024-08-03T02:10:12.421Z (5 months ago)
Topics: android, caching-scrobbles, fm-scrobbler, java, libre, listenbrainz, music-apps, scrobbler, sls
Language: Java
Homepage: https://simple-last-fm-scrobbler.github.io
Size: 7.8 MB
Stars: 549
Watchers: 39
Forks: 100
Open Issues: 63
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project

awesome-starred - sls - Simple Scrobbler, for Android -- last.fm, libre.fm & ListenBrainz (Java)
README

        # Simple Scrobbler

[](https://github.com/simple-last-fm-scrobbler/sls/blob/master/art/icon_new.svg) [![Build Status](https://travis-ci.com/simple-last-fm-scrobbler/sls.svg?branch=master)](https://travis-ci.com/simple-last-fm-scrobbler/sls) [![GitHub release](https://img.shields.io/github/release/simple-last-fm-scrobbler/sls)](https://github.com/simple-last-fm-scrobbler/sls/releases/) [![GitHub release](https://img.shields.io/github/release-pre/simple-last-fm-scrobbler/sls)](https://github.com/simple-last-fm-scrobbler/sls/releases/) [![License](http://img.shields.io/:license-apache-blue.svg?style=round)](LICENSE.md) [![Pull Requests](https://img.shields.io/github/issues-pr/simple-last-fm-scrobbler/sls.svg?style=round)](https://github.com/simple-last-fm-scrobbler/sls/pulls) [![Gitter](https://img.shields.io/gitter/room/tgwizard/sls.svg?logo=gitter&style=round)](https://gitter.im/tgwizard/sls) ![Discord](https://img.shields.io/discord/722441132260458496)

[![Discord](https://img.shields.io/discord/722441132260458496.svg?logo=discord&style=round)](https://discord.gg/KqYGnAX)

[![Feature Requests](https://img.shields.io/github/issues/simple-last-fm-scrobbler/sls/feature%20request.svg?style=round)](https://github.com/simple-last-fm-scrobbler/sls/labels/feature%20request) [![App Support Issues](https://img.shields.io/github/issues/simple-last-fm-scrobbler/sls/app%20support.svg?style=round)](https://github.com/simple-last-fm-scrobbler/sls/labels/app%20support) [![Bugs Issues](https://img.shields.io/github/issues/simple-last-fm-scrobbler/sls/bugs.svg?style=round)](https://github.com/simple-last-fm-scrobbler/sls/labels/bugs) [![Issues](https://img.shields.io/github/issues/simple-last-fm-scrobbler/sls.svg?style=round)](https://github.com/simple-last-fm-scrobbler/sls/issues) [![Serious Issues](https://img.shields.io/github/issues/simple-last-fm-scrobbler/sls/serious.svg?style=round)](https://github.com/simple-last-fm-scrobbler/sls/labels/serious)

[![Critical Issues](https://img.shields.io/github/issues/simple-last-fm-scrobbler/sls/critical.svg?style=round)](https://github.com/simple-last-fm-scrobbler/sls/labels/critical)

#### New Permission Privacy Concerns Explained -- [Privacy Explained](https://github.com/simple-last-fm-scrobbler/sls/wiki/Privacy-Concerns)

### Translators! Your Help Is Needed.

 * ###### Head to [OpenSkyApp](https://os0hucc.oneskyapp.com/admin/project/dashboard/project/344237) for exact translator information.

Simple Scrobbler (SS) is a simple app that scrobbles music listened to on an Android phone. Scrobbling means submitting listening information to Last.fm (and optionally/additionally Libre.fm and ListenBrainz) when you play a track, and you can then get music recommendations and view you listening history and statistics at Last.fm.

Before the release of a new version of SLS, it will be available here to test for one week in [GitHub Releases](https://github.com/simple-last-fm-scrobbler/sls/releases).

 * More info about scrobbling can be found on [Last.fm's FAQ](http://www.last.fm/help/faq?category=Scrobbling#201).

 * More info about scrobbling from the community can be found on [getsatisfaction.com/lastfm](https://getsatisfaction.com/lastfm).

 * More info about scrobbling from [Libre.fm's Project Page](https://git.gnu.io/foocorp/librefm/wikis/home).

 * More info about listens from [ListenBrainz's FAQ](https://listenbrainz.org/faq).

## Problem or Issue?

  * Please create a [GitHub Account](https://github.com/join) so you can create a [GitHub Issue](https://github.com/simple-last-fm-scrobbler/sls/issues) and PLEASE use the next sections as guides. You will get help with bugs and problems with the software. For direct personal contact with developers, please use [Gitter](https://gitter.im/tgwizard/sls) or [Discord](https://discordapp.com/channels/722441132260458496).

  * ### Issue (Bug Report) Example

    * **SLS Version (required)**: (1.5.8)

    * **Issue (required)**: (Brief description of your bug or issue)

    * **Parameters (required):**

      * **What**: {App Crashing, Scrobble Failure, or (you tell us)}

      * **Where**: {App Screen, Notifications, Hidden or (you tell us)}

      * **When**: {ex. "I clicked Scrobble Now", "I don't know", or (you tell us)}

      * **Why**: {ex. "Because I clicked Scrobble Now.", "I don't know.", or (you tell us)}

      * **How**: {ex. "Automatic", "Manual Button Click", "I don't know.", or (you tell us)}

    * *Android Version (preferred)*: (9)

    * *Music App(s) (preferred)*: (ex. Google Play Music, Spotify)

    * *Detected Music Apps(s) (preferred)*: (List what apps SLS detected)

    * *Enabled Settings (preferred)*: (List what options you have enabled)

    * Phone Model (optional): (Samsung S10)

  * ### Issue (Feature Request) Example

    * **Request for Feature (required)**: (control over scrobbled data)

    * **Reason (required)**: (Scrobble is love, scrobble is life.)

## Download

[

    ](https://play.google.com/store/apps/details?id=com.adam.aslfms&pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1)

[](https://f-droid.org/packages/com.adam.aslfms)

#### [Release & Pre-Release Downloads](https://github.com/simple-last-fm-scrobbler/sls/releases)

## Compatible Apps & Compatible Phones

### [(To View Compatible Apps and Phones Click Here)](Compatability.md)

#### Known compatible devices

**Note.** SLS should work on any device that can install it, and that can run one of the music apps above.

## Notices

 * SLS is maintained by a few dedicated programmers.

## Developers

 * Contributors are welcome!

 * Revisions will be requested if the changes are not working.

 * Please let us know if you have added strings that need translation in Pull Requests.

 * Please let us know if you have added strings that have not been made into string variables in Pull Requests.

 * Somebody will make the necessary changes for you if you do not have the time.

 * Head to [Transifex](https://www.transifex.com/sls/sls) if you want to be a translator.

 * Create an issue when you are done translating or create a pull request. Whatever you are comfortable with.

## Core Tasks

1. #### Core bugs/issues

 * [Repeat Song For Some Music Apps](https://github.com/simple-last-fm-scrobbler/sls/issues/324)

 * Language support is lagging behind for some features that have been added recently.

 * Enforce (maybe hack) the scrobbling rules for each service using error codes correctly by API. (ex last.fm scrobble too new/old)

2. #### Core Bugs/Features

 * [Simpler Love Track](https://github.com/simple-last-fm-scrobbler/sls/issues/303) [Similar Issue](https://github.com/simple-last-fm-scrobbler/sls/issues/330)

 * [Enable/Disable Individual Music App Scrobbles](https://github.com/simple-last-fm-scrobbler/sls/issues/200) [Similar Issue](https://github.com/simple-last-fm-scrobbler/sls/issues/367)

 * [Blocking Podcast Scrobbles](https://github.com/simple-last-fm-scrobbler/sls/issues/127)

 * Read Notifications to Scrobble Music Also

 * Use Android audio focus detection to manage scrobbling.

 * Slow overhaul of the app to keep simplicity and allow for dynamic feature/functionality addition.

 * Replace legacy user/pass with OAuth dance

 * Possibly style intents and notifications similar to [https://github.com/peterjosling/scroball](https://github.com/peterjosling/scroball)

3. #### Core Feature Requests

 * [True Material Design Upgrade](https://github.com/simple-last-fm-scrobbler/sls/issues/227)

 * [Better Unit Tests](https://github.com/simple-last-fm-scrobbler/sls/issues/12)

 * [Notification Level](https://github.com/simple-last-fm-scrobbler/sls/issues/346)

 * Unsecured http:// support for custom servers

 * ListenBrainz API for Total Listen Count

 * Word blacklist for blocking things like podcasts or tracks on mixed media apps. "Intelligent noise filter"

 * Multiple Account Login

 * Sequential storage of all tracks, scrobbled, skipped, hearted, and failed with explanations

 * markers in scrobble cache for logged in accounts

 * Store scrobbles before user is logged in

 * Manual scrobbling, for example Vinyl Records, CD, Cassette and other older media machines.

 * Import database

 * Keep more variables in the database including past scrobbles, old scrobbles and statistics

 * .. essentially better internal data management

## Features

 * Scrobbling

 * Now playing notifications

 * Power-saving settings

 * Caching scrobbles (while offline or through settings)

 * Editing scrobble cache

 * Auto-correct scrobbles

 * Enable/Disable Music Apps

 * Themes

 * More

### Supported languages

 * ###### Head to [OpenSkyApp](https://os0hucc.oneskyapp.com/admin/project/dashboard/project/344237) for exact translator information.

 * English

 * Spanish

 * French

 * German

 * Brazilian Portuguese

 * Polish

 * Russian

 * Czech

### Supported scrobble services

## Last.fm, Libre.fm, ListenBrainz(.org), and Custom Personal Servers

### [![last.fm](art/last_fm.svg)](https://last.fm) [![libre.fm](art/libre_fm.svg)](https://libre.fm) [![ListenBrainz](art/ListenBrainz.svg)](https://listenbrainz.org)

####  there is also developer server options

 * [Custom GNU-fm/Libre.fm Server](https://git.gnu.io/gnu/gnu-fm/blob/master/gnufm_install.txt)

 * [Custom ListenBrainz Server](https://github.com/metabrainz/listenbrainz-server/blob/master/README.md)

### Changes

For a complete list of changes, see [the changelog](app/src/main/assets/changelog.txt).

## Bugs, Contributions, Thoughts...

First, read the [FAQ](FAQ.md) to see if you can find any help with your issue.

If you can't find it there, you can always open an issue or pull request here on GitHub.

## Credits

All of the code is open source, released under [Apache License 2.0](LICENSE.md).

 * Almost all of the code is written by me, so: Copyright 2009-2015 Adam Renberg.

 * The Last.fm logo is copyright of Last.fm, taken from their [media kit](http://www.last.fm/resources).

 * The Libre.fm logo is probably copyright of Libre.fm, used in good faith. (Because of their name and stated mission, I assume it is okay).

I use copyright here only in the sense of proper attribution. Do whatever you want with the code (as long as the licenses are followed).

### Contributors

#### A complete and updated list here -> [CONTRIBUTORS LIST](https://github.com/simple-last-fm-scrobbler/sls/graphs/contributors)

 * Adam Renberg, [github.com/tgwizard](https://github.com/tgwizard), main author

 * Argoday, [github.com/argoday](https://github.com/argoday), code fixes

 * inverse [github.com/inverse](https://github.com/inverse), core contributor

 * Austin H, [github.com/a93-39a](https://github.com/a93-39a), core contributor

 * Sean O'Neil, [github.com/SeanPONeil](https://github.com/SeanPONeil), android 4.0

 * Andrew Thomson, support for MIUI Music Player

 * Mark Gillespie, support for Sony/Sony Ericsson/Xperia phones

 * Dmitry Kostjuchenko, support for Neutron Music Player

 * stermi, support for Rdio

 * Joseph Cooper, [github.com/grodin](https://github.com/grodin), support for JRTStudio Android Music Player

 * Shahar, [github.com/kshahar](https://github.com/kshahar), support for LG Music Player

 * theli-ua, [github.com/theli-ua](https://github.com/theli-ua), support for Amazon Music

 * metanota, [github.com/metanota](https://github.com/metanota), support for PlayerPro, bug fixes

 * Joel Teichroeb, [github.com/klusark](https://github.com/klusark), bug fixes

 * Tha PHLASH, [thaphlash.com](http://www.thaphlash.com/), old icon

 * pierreduchemin [github.com/pierreduchemin](https://github.com/pierreduchemin), French translation

 * moshpirit [github.com/moshpirit](https://github.com/moshpirit), Spanish translation

 * bryansills [github.com/bryansills](https://github.com/bryansills), Eclipse to Android Studio, new icon, Material Design

 * herrherrmann [github.com/herrherrmann](https://github.com/herrherrmann), German translation

 * Alia5 [github.com/Alia5](https://github.com/Alia5), better Enabled apps handle

 * MendelGusmao [github.com/MendelGusmao](https://github.com/MendelGusmao), Brazil Portuguese Translation

 * Grzes58 [github.com/Grzes58](https://github.com/Grzes58), Polish

 * bajituka [github.com/bajituka](https://github.com/bajituka), Russian

### Test device contributors

 * Dmitry Paskal, [github.com/paskal](https://github.com/paskal)

 * Iļja Gubins, [https://github.com/the-lay](https://github.com/the-lay)

Several people have also contributed with comments, suggestions and [issues](https://github.com/simple-last-fm-scrobbler/sls/issues/).