Giter Club home page Giter Club logo

openwebscrobbler's Introduction

Open Scrobbler Discord Patreon

Screenshot

What is this?

An open source scrobbler for the web. Just login and scrobble the track(s) you want! This tool lets you scrobble songs you heard on the radio, vinyls or at some place where you need to manually scrobble.

You may use it directly from here: https://openscrobbler.com/

What is scrobbling, you ask? It's tracking the music you listen to, using last.fm.

Help us make it better!

This tool is open source and free. You can support its development by becoming a Patron (you'll have a distinct identifier in the application and get a sneak peek into what's coming next! โœจ )

Contributing

Contributions and suggestions are welcome. If you want to work on a fix/feature I recommend you to open an issue (or comment on an existing one) before you start working so we can coordinate efforts.

Issues labeled with "help wanted" are perfect candidates!

Translations

Translating is very easy. Here's a short guide (if you get stuck let me know on Discord or open an issue).

Adding a new language

  1. Fork this project if you haven't already, so you can edit it.
  2. Create a folder for your language in the locales directory, copying the files in en language.
  3. Translate all the values in the JSON files (for example, in a line that says "foo": "bar", you should translate only the bar part).
  4. Add you language to the language list in src/i18n.js
  5. Duplicate one hreflang tag in the index.html and modify it to fit your language.
  6. Once you are done, the only thing left is creating a pull request so it can be merged with the current code. :confetti:

Improve an existing language

  1. Fork this project if you haven't already, so you can edit it.
  2. Find the folder corresponding to your language in locales directory.
  3. Translate or modify the values you want in the JSON files in that directory.
  4. Create a pull request so it can be merged back into this repository. ๐ŸŽ‰

Setup

You'll need a Last.fm API account!

  • Run yarn to download the required libraries.
  • Copy .env to .env.development.local and fill in the required constants.
  • Docker and Docker Compose are required to run the API server locally.

Development

Just start the application with yarn start (it will launch both the API server and the React application). A database debugging utility will be available on localhost:8080. All changes to the database schema must be added as migrations (use migration #1 as a guiding template) and remain backwards compatible. All new migrations are applied automatically in the development containers (just keep in mind that each migration runs only once, so you may need to manually revert any failed attempt).

Building

The build script should be enough! :)

Thank you!

One of the best things about open source is the great community around projects. The Open Scrobbler has several contributors and each one of them has made this tool better for everyone. Thanks to all of them!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.