MCPcopy
hub / github.com/web-scrobbler/web-scrobbler

github.com/web-scrobbler/web-scrobbler @v4.0.0 sqlite

repository ↗ · DeepWiki ↗ · release v4.0.0 ↗
931 symbols 2,193 edges 419 files 302 documented · 32%
README
<img width="128" src="https://github.com/web-scrobbler/web-scrobbler/raw/v4.0.0/src/icons/main/universal.svg"/>

Web Scrobbler

Chrome Web Store Addons.mozilla.org Microsoft Edge Addons

Discord Test status Codacy Badge Codacy Coverage Badge

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

Supported Services

Installation

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

Chrome Web Store

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

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

Addons.mozilla.org

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

Microsoft Edge Add-ons

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

Install from source code

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

Development

Build the extension

Before building the extension you should install dependencies:

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

Develop connectors

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

Translations

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

Media

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

Join the Discord channel to discuss the extension.

Privacy Policy

See the privacy policy.

License

Licensed under the MIT License.

Extension points exported contracts — how you extend this code

PopupCommunications (Interface)
* This file deals with communication between the different scripts. * It uses continuations to restrict type to a singl
src/util/communication.ts
TimeInfo (Interface)
(no doc)
src/core/types.ts
TestData (Interface)
(no doc)
tests/types/types.ts
SpecificContentListener (Interface)
* Content listeners
src/util/communication.ts
ArtistTrackInfo (Interface)
(no doc)
src/core/types.ts
SpecificBackgroundListener (Interface)
* Background listeners
src/util/communication.ts
TrackInfoWithAlbum (Interface)
(no doc)
src/core/types.ts
SpecificPopupListener (Interface)
* popup listeners
src/util/communication.ts

Core symbols most depended-on inside this repo

t
called by 164
src/util/i18n.ts
applyFilter
called by 61
src/core/scrobbler/lastfm/lastfm-scrobbler.ts
debugLog
called by 58
src/core/storage/wrapper.ts
get
called by 48
src/core/storage/wrapper.ts
set
called by 45
src/core/storage/wrapper.ts
getStorage
called by 24
src/core/storage/regex-edits.ts
colorLog
called by 23
scripts/log.ts
debugLog
called by 20
src/core/object/controller/controller.ts

Shape

Function 672
Method 161
Interface 51
Class 42
Enum 5

Languages

TypeScript100%

Modules by API surface

src/core/object/controller/controller.ts41 symbols
src/core/content/util.ts37 symbols
src/core/object/song.ts31 symbols
src/core/scrobbler/listenbrainz/listenbrainz-scrobbler.ts23 symbols
src/core/storage/wrapper.ts20 symbols
src/core/storage/options.ts19 symbols
src/connectors/bandcamp.ts19 symbols
src/util/communication.ts18 symbols
tests/background/song.test.ts17 symbols
src/core/scrobbler/maloja/maloja-scrobbler.ts17 symbols
src/core/scrobbler/base-scrobbler.ts17 symbols
src/core/scrobbler/audio-scrobbler/audio-scrobbler.ts17 symbols

Dependencies from manifests, versioned

@suid/icons-material0.6.2 · 1×
@types/archiver5.3.2 · 1×
@types/blueimp-md52.18.0 · 1×
@types/fs-extra11.0.1 · 1×
@types/imagemin8.0.1 · 1×
@types/imagemin-jpegtran5.0.1 · 1×
@types/node20.2.1 · 1×
@types/react18.2.6 · 1×
@typescript-eslint/eslint-plugin5.59.6 · 1×
@web-scrobbler/metadata-filter3.0.1 · 1×
archiver5.3.1 · 1×

For agents

$ claude mcp add web-scrobbler \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact