Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/web-scrobbler/web-scrobbler

Scrobble music all around the web!
https://github.com/web-scrobbler/web-scrobbler

chrome-extension edge-addon firefox-addon hacktoberfest lastfm librefm listenbrainz safari-extension webextension

Last synced: 29 days ago
JSON representation

Scrobble music all around the web!

Awesome Lists containing this project

README

        




Web Scrobbler

[![Chrome Web Store][WebStoreBadge]][WebStore]
[![Addons.mozilla.org][AmoBadge]][Amo]
[![iTunes App Store][AppleStoreBadge]][AppleStore]
[![Microsoft Edge Addons][EdgeBadge]][Edge]

[![Discord][DiscordBadge]][Discord]
[![Test status][GitHubActionsBadge]][GitHubActions]
[![Codacy Badge][CodacyBadge]][Codacy]
[![Codacy Coverage Badge][CodacyCoverageBadge]][Codacy]

Web Scrobbler helps online music listeners to scrobble their playback history.

## Supported Services

- [Last.fm][LastFm]
- [Libre.fm][LibreFm]
- [ListenBrainz][ListenBrainz]
- [Maloja][Maloja]
- [Pleroma][Pleroma]

## Installation

The extension can be either downloaded from stores, or installed as an [unpacked extension][DocsUnpacked].

### Chrome Web Store

It can be installed directly from the [Chrome Web Store][WebStore] for Chrome users.

Opera users can install the extension from Chrome Web Store using the
[Download Chrome Extension][DownloadChromeExt] addon for Opera.

### Addons.mozilla.org

For those who prefer Firefox, the extension is available on [Addons.mozilla.org][Amo].

### Safari

The extension is also available in the [Apple Store][AppleStore].

### Microsoft Edge Add-ons

The extension is also avaiable on the [Microsoft Edge Add-ons][Edge].

### Install from source code

To install the extension from sources or zip file, read
[this page][WikiUnpacked] if you're on Chrome, or [this one][WikiTempAddon]
if you use Firefox.

## Development

### Build the extension

Before building the extension you should install dependencies:

```sh
# Install dependencies
> npm install

# Build the extension
> npm run build firefox
# or
> npm run build chrome
# or (requires Xcode (xcrun and xcodebuild))
> npm run build safari
```

The built extension is available in `build` directory. You can install it as an
unpacked extension from this directory.

The detailed build instruction is available [here][BuildInstructions].

### Develop connectors

Check the [wiki page][WikiDev] to understand development of connectors. Please
also read our [contribution guidelines][Contributing].

### Translations

We use Transifex to maintain translations. If you want to translate
the extension, follow the [translations][Translations] wiki page for details.

## Media

Follow [@web_scrobbler][Twitter] on Twitter to receive the latest news and updates.

Join the [Discord channel][Discord] to discuss the extension.

## Privacy Policy

See the [privacy policy][Privacy].

## License

Licensed under the [MIT License][License].

[AmoBadge]: https://img.shields.io/amo/v/web-scrobbler.svg?label=firefox&logo=firefox-browser&logoColor=white
[CodacyBadge]: https://img.shields.io/codacy/grade/32658c34c5c542d9a315ead8d5eadd0e?logo=codacy&logoColor=white
[CodacyCoverageBadge]: https://img.shields.io/codacy/coverage/32658c34c5c542d9a315ead8d5eadd0e?logo=codacy&logoColor=white
[DiscordBadge]: https://img.shields.io/discord/716363971070001202?logo=discord&logoColor=white&color=7289dA
[EdgeBadge]: https://img.shields.io/badge/dynamic/json?label=edge&logo=microsoft-edge&query=%24.version&url=https%3A%2F%2Fmicrosoftedge.microsoft.com%2Faddons%2Fgetproductdetailsbycrxid%2Fobiekdelmkmlgnhddmmnpnfhngejbnnc
[GitHubActionsBadge]: https://img.shields.io/github/actions/workflow/status/web-scrobbler/web-scrobbler/test.yml
[WebStoreBadge]: https://img.shields.io/chrome-web-store/v/hhinaapppaileiechjoiifaancjggfjm.svg?label=chrome&logo=google-chrome&logoColor=white
[AppleStoreBadge]: https://img.shields.io/itunes/v/6449224218?label=safari&logo=apple&logoColor=white

[BuildInstructions]: https://github.com/web-scrobbler/web-scrobbler/wiki/Setup-development-environment
[Contributing]: https://github.com/web-scrobbler/web-scrobbler/blob/master/.github/CONTRIBUTING.md
[DocsUnpacked]: https://developer.chrome.com/extensions/getstarted#unpacked
[License]: https://github.com/web-scrobbler/web-scrobbler/blob/master/LICENSE.md
[Privacy]: https://github.com/web-scrobbler/web-scrobbler/blob/master/src/_locales/en/privacy.md
[Translations]: https://github.com/web-scrobbler/web-scrobbler/wiki/Translate-the-extension

[Amo]: https://addons.mozilla.org/en-US/firefox/addon/web-scrobbler/
[Edge]: https://microsoftedge.microsoft.com/addons/detail/web-scrobbler/obiekdelmkmlgnhddmmnpnfhngejbnnc
[WebStore]: https://chrome.google.com/webstore/detail/lastfm-scrobbler/hhinaapppaileiechjoiifaancjggfjm
[AppleStore]: https://apps.apple.com/app/web-scrobbler/id6449224218

[DownloadChromeExt]: https://addons.opera.com/extensions/details/app_id/kipjbhgniklcnglfaldilecjomjaddfi

[Codacy]: https://app.codacy.com/gh/web-scrobbler/web-scrobbler/dashboard
[Discord]: https://discord.com/invite/u99wNWw
[GitHubActions]: https://github.com/web-scrobbler/web-scrobbler/actions
[Twitter]: https://twitter.com/web_scrobbler

[LastFm]: http://www.last.fm/
[LibreFm]: https://libre.fm/
[ListenBrainz]: https://listenbrainz.org/
[Maloja]: https://github.com/krateng/maloja
[Pleroma]: https://pleroma.social/

[WikiDev]: https://github.com/web-scrobbler/web-scrobbler/wiki/Connectors-development
[WikiTempAddon]: https://github.com/web-scrobbler/web-scrobbler/wiki/Install-a-temporary-add-on
[WikiUnpacked]: https://github.com/web-scrobbler/web-scrobbler/wiki/Install-an-unpacked-extension