Skip to content

Latest commit

 

History

History
204 lines (151 loc) · 12.6 KB

README.md

File metadata and controls

204 lines (151 loc) · 12.6 KB
Raw

Simple Scrobbler

Icon Build Status GitHub release GitHub release License Pull Requests Gitter Discord Discord

Feature Requests App Support Issues Bugs Issues Issues Serious Issues Critical Issues

New Permission Privacy Concerns Explained -- Privacy Explained

Translators! Your Help Is Needed.

  • Head to OpenSkyApp 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.

Problem or Issue?

  • Please create a GitHub Account so you can create a GitHub Issue 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 or Discord.

  • 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

Get it on PlayStore Get it on F-Droid

Release & Pre-Release Downloads

Compatible Apps & Compatible Phones

(To View Compatible Apps and Phones Click Here)

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 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
  • 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)

  1. Core Bugs/Features

  1. Core Feature Requests

  • True Material Design Upgrade
  • Better Unit Tests
  • Notification Level
  • 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 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 libre.fm ListenBrainz

there is also developer server options

Changes

For a complete list of changes, see the changelog.

Bugs, Contributions, Thoughts...

First, read the FAQ 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.

  • 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.
  • 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

Test device contributors

Several people have also contributed with comments, suggestions and issues.