https://github.com/nhas/tracker-extension
https://github.com/nhas/tracker-extension
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/nhas/tracker-extension
- Owner: NHAS
- Created: 2026-04-09T21:39:12.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-09T22:45:27.000Z (2 months ago)
- Last Synced: 2026-04-10T00:26:07.944Z (2 months ago)
- Language: JavaScript
- Size: 143 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# YTMusic Grabber — Firefox Extension
Grab the currently playing YouTube Music track and ship its video id to a local (or remote) yt-dlp HTTP wrapper.
---
## Install
1. Open Firefox and go to `about:debugging#/runtime/this-firefox`
2. Click **Load Temporary Add-on…**
3. Select the `manifest.json` file inside this folder
For a permanent install, sign the extension via [Firefox Add-on Developer Hub](https://addons.mozilla.org/developers/).
Or used the signed extension in `web-ext-artifacts`
---
## Building
```sh
web-ext lint --self-hosted
web-ext build --overwrite-dest
```
Then uplaod to the mozilla extensions platform
## Usage
As long as the extension is loaded an registered with a corrosponding `https://github.com/NHAS/ytdlp-api` service it will just run in the background recording songs every time you're on https://music.youtube.com.
You can open the extension and see if it is connected successifully to a service.
If the service is down it will look like this:
## Registration
Please see the server instructions for registration
https://github.com/NHAS/ytdlp-api?tab=readme-ov-file#registration
---
## Settings
| Field | Default | Description |
|---|---|---|
| HTTP POST URL | `http://localhost:8080/` | Where the `https://github.com/NHAS/ytdlp-api` root is |
| API key | *(empty)* | Required api key for adding songs |
---
## POST body
```json
{
"title": "Song Title",
"artist": "Artist Name",
"videoId": "VIDEO_ID"
}
```
---
## Permissions used
| Permission | Reason |
|---|---|
| `activeTab` | Read the current YTM tab to extract track info |
| `storage` | Persist your service URL and settings |
| `https://music.youtube.com/*` | Inject the content script |
No data is sent anywhere except the service URL you configure.