KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #deepseek-harness #typescript #ai-agent #codex #developer-tools #claude-code #windows #mcp #python #desktop-app

plugin.audio.ytmusic.exp

★ 41 Open GitHub ↗

Experimental Youtube Music for kodi created by Foreverguest

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Kodi version](https://img.shields.io/badge/kodi%20versions19-blue)](https://kodi.tv/)
[![License: GPL3](https://img.shields.io/badge/License-GPL3-yellow.svg)](https://opensource.org/licenses/GPL-3.0)

# YT Music (plugin.audio.ytmusic.exp)

This addon is a rewrite of the Experimental Google Music addon to Youtube Music made by Foreverguest.

All credit goes to Foreverguest.

# Used libraries and versions

- https://github.com/sigma67/ytmusicapi/tree/1.11.4
- https://github.com/JuanBindez/pytubefix/tree/v8.12.1

## Requires:

Kodi 19 Matrix

# Installation & Updates

_You can install it via repository to provide automatic updates (future updates may require to rebuild database)_

- Download repository: [repository.ytmusic](https://github.com/Goldenfreddy0703/repository.ytmusic/blob/master/repository.ytmusic-1.0.zip?raw=true)
- Or install it via Kodi file-manager
  - add source: <https://goldenfreddy0703.github.io/repository.ytmusic>

_or install it manually (updates should be installed manually)_

- [plugin.audio.ytmusic.exp](https://github.com/Goldenfreddy0703/plugin.audio.ytmusic.exp/archive/refs/heads/main.zip)

## Authentication using headers

Unfortunately, the use of OAuth is no longer supported by YTMusic. Instead, on first run, the add-on will ask for a headers file with cookie data from your web session. The plugin will accept either 'raw header files' or 'JSON files'.

### Obtaining authentication headers

Please follow the guide below to obtain authentication headers.
For longer-lasting cookies, it is recommended that you do everything in a fresh, private browsing session. After obtaining the cookie, close the private browser immediately (but do not sign out of YouTube).

[https://ytmusicapi.readthedocs.io/en/stable/setup/browser.html#copy-authentication-headers](https://ytmusicapi.readthedocs.io/en/stable/setup/browser.html#copy-authentication-headers)

### Using the authentication headers

- Copy the request headers to a plain text file that you place in a path which is accessible from within Kodi.
- Start the add-on and navigate to a menu item requiring authenticated access to YTMusic, e.g. YTMusic Library -> Artist subscriptions.
- A pop-up will open asking you to choose either Raw Headers or JSON.
- Select Raw Headers.
- Navigate to the plain text file created in the first step and click on OK.
- YTMusic.Exp converts the raw headers to a headers_auth.json file which is stored in userdata/addon_data/plugin.audio.ytmusic.exp and will authenticate from now on using the information contained therein.

## NEW: Unlimited Playlist Loading (YouTube v3 API)

This addon now supports loading complete playlists without the 100-song limitation! By default, the addon uses YouTube v3 Data API (the same approach as the successful YouTube addon) to load unlimited playlist items.

### Benefits:
- **No more 100-song limit**: Load playlists with thousands of songs
- **Proven reliability**: Uses the same method as the YouTube addon
- **Automatic fallback**: Falls back to YouTube Music API if needed

### Setup (Recommended):
1. Get a YouTube Data API v3 key from [Google Cloud Console](https://console.cloud.google.com/)
2. Enable "YouTube Data API v3" for your project
3. Add the API key in addon settings under "YouTube API Key"

Without an API key, the addon will fall back to YouTube Music API (limited to ~100 songs per playlist).

**For detailed setup instructions, see [YOUTUBE_V3_README.md](YOUTUBE_V3_README.md)**

## Donations:

[Donations for this addon gratefully accepted](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VH2UFT2Y3PZZN&lc=BR&item_name=foreverguest&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted).

Note: All Donations will be going to Foreverguest.

## Versions:

From 1.0~beta8 ongoing you can find the releases under [Releases](https://github.com/Goldenfreddy0703/plugin.audio.ytmusic.exp/releases).

## Older:

[plugin.audio.ytmusic.exp-1.0~beta7](https://github.com/Goldenfreddy0703/plugin.audio.ytmusic.exp/archive/d7372dd4b04ba30950389352935e534c3e0bace2.zip)

[plugin.audio.ytmusic.exp-1.0~beta6](https://github.com/Goldenfreddy0703/plugin.audio.ytmusic.exp/archive/99b245a7eb2d2d2844c61e3f6e32d9343d8f2bb2.zip)

[plugin.audio.ytmusic.exp-1.0~beta5](https://github.com/Goldenfreddy0703/plugin.audio.ytmusic.exp/archive/4e360a43a2c04815daef7171e360b056a3204965.zip)
- Update ytmusicapi and pytube thanks to @woernsn.

[plugin.audio.ytmusic.exp-1.0~beta4](https://app.box.com/s/381gbuuzcu1diletnpjmfnqxnwm6mcw0)

[plugin.audio.ytmusic.exp-1.0~beta3](https://app.box.com/s/bc9xbr4nvjqyfrul0wligozzj6de0ke9)

[plugin.audio.ytmusic.exp-1.0~beta2](https://app.box.com/s/4a0jly0ezg9pe21hyi3sbmbbpnxtabha)

[plugin.audio.ytmusic.exp-1.0~beta1](https://app.box.com/s/d9tcjkan4ih3oa5d8ain13ybuydjnp5a)

## TODO:

- [ ] extend headless mode to song, album and playlist context menus
- [x] implement OAuth login
- [x] support adaptive streaming
- [x] add playlist operations
- [x] add Android/Linux support
- [x] make Youtube Music thumbnails have better resolution
- [x] adding icons in the future

## Help needed with maintaining!!!

I am very clueless on this project currently cause this addon was made by foreverguest who has done a very great job maintaining this addon. Be aware that this is a community driven project, so feel free to submit PR's yourself to improve the code and/or help others with support on the forums etc. If you're willing to really participate in the development, please contact me so I can give you write access to the repo. I will do my best to maintain the project for foreverguest. Thanks for understanding!

All credit goes to foreverguest

## License

Licensed under The GPL License.

plugin.audio.ytmusic.exp

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README