mirror of
https://github.com/IAmParadox27/jellyfin-plugin-media-bar.git
synced 2026-11-06 07:40:21 +01:00
159 lines
7.9 KiB
Markdown
159 lines
7.9 KiB
Markdown
<h1 align="center">Media Bar</h1>
|
|
<h2 align="center">A Jellyfin Plugin</h2>
|
|
<p align="center">
|
|
<img alt="Logo" src="https://raw.githubusercontent.com/IAmParadox27/jellyfin-plugin-media-bar/main/src/logo.png" />
|
|
<br />
|
|
<br />
|
|
<a href="https://github.com/IAmParadox27/jellyfin-plugin-media-bar/?tab=License-1-ov-file">
|
|
<img alt="DBAD" src="https://img.shields.io/badge/license-DBAD-blue" />
|
|
</a>
|
|
<a href="https://github.com/IAmParadox27/jellyfin-plugin-media-bar/releases">
|
|
<img alt="Current Release" src="https://img.shields.io/github/release/IAmParadox27/jellyfin-plugin-media-bar.svg" />
|
|
</a>
|
|
</p>
|
|
|
|
## Reporting Issues
|
|
|
|
If you face issues relating to the visuals or behaviour of buttons added by the Media Bar please report them on MakD's repo (the one this is forked from). This plugin pulls the content from their repo directly and is only in control of adding it without the need for modifying your JF install files.
|
|
|
|
Any issues with plugin's settings (including using a playlist as your avatar's playlist) should be made here.
|
|
## Development Update - 20th August 2025
|
|
|
|
Hey all! Things are changing with my plugins are more and more people start to use them and report issues. In order to make it easier for me to manage I'm splitting bugs and features into different areas. For feature requests please head over to <a href="https://features.iamparadox.dev/">https://features.iamparadox.dev/</a> where you'll be able to signin with GitHub and make a feature request. For bugs please report them on the relevant GitHub repo and they will be added to the <a href="https://github.com/users/IAmParadox27/projects/1/views/1">project board</a> when I've seen them. I've found myself struggling to know when issues are made and such recently so I'm also planning to create a system that will monitor a particular view for new issues that come up and send me a notification which should hopefully allow me to keep more up to date and act faster on various issues.
|
|
|
|
As with a lot of devs, I am very momentum based in my personal life coding and there are often times when these projects may appear dormant, I assure you now that I don't plan to let these projects go stale for a long time, there just might be times where there isn't an update or response for a couple weeks, but I'll try to keep that better than it has been. With all new releases to Jellyfin I will be updating as soon as possible, I have already made a start on 10.11.0 and will release an update to my plugins hopefully not long after that version is officially released!
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
- This plugin is based on Jellyfin Version `10.10.7`
|
|
- The following plugins are required to also be installed, please following their installation guides:
|
|
- File Transformation (https://github.com/IAmParadox27/jellyfin-plugin-file-transformation) at least v2.2.1.0
|
|
|
|
### Installation
|
|
1. Add `https://www.iamparadox.dev/jellyfin/plugins/manifest.json` to your plugin repositories.
|
|
2. Install `Media Bar` from the Catalogue.
|
|
3. Restart Jellyfin.
|
|
4. Force refresh your webpage (or app) and you should see your new Media Bar at the top of the home page.
|
|
## Upcoming Features/Known Issues
|
|
If you find an issue with any of the sections or usage of the plugin, please open an issue on GitHub.
|
|
|
|
### FAQ
|
|
|
|
#### I've updated Jellyfin to latest version but I can't see the plugin available in the catalogue
|
|
|
|
The likelihood is the plugin hasn't been updated for that version of Jellyfin and the plugins are strictly 1 version compatible. Please wait until an update has been pushed. If you can see the version number in the release assets then please make an issue, but if its not in the assets, please wait. I know Jellyfin has updated, I'll update when I can.
|
|
|
|
#### I've installed the plugins and the media bar doesn't appear. How do I fix?
|
|
This is common, particularly on a fresh install. The first thing you should try is the following
|
|
1. Launch your browsers developer tools
|
|
|
|
|
|
|
|
3. Open the **Network** tab across the top bar
|
|
4. Check the **Disable cache** checkbox
|
|
5. Refresh the page **while the dev tools are still open**
|
|
|
|
|
|
|
|
## Credits
|
|
Credits for this plugin go to @MakD for his original work and to @BobHasNoSoul and @SethBacon for their influence to MakD. For full credits see below in the original README content
|
|
|
|
## Original README
|
|
|
|
<details>
|
|
<summary>Original README.md from MakD</summary>
|
|
|
|
# Jellyfin-Media-Bar - Now with Play Now Function
|
|
|
|
|
|
|
|
|
|
|
|
**IMP UPDATE — We have dropped support for the normal CSS version (for now). _(It still works, but there will be no further updates till the fullscreen mode is stabilized)_**
|
|
|
|
The fullscreen version has a new look (in beta), and support for different screen sizes has been added. For any visual goof-ups, please open a bug report, including the device being used and whether it is encountered in portrait or landscape mode.
|
|
|
|
|
|
Thanks to the Man, the Legend [BobHasNoSoul](https://github.com/BobHasNoSoul) for his work on the [jellyfinfeatured](https://github.com/BobHasNoSoul/jellyfin-featured) and [SethBacon](https://forum.jellyfin.org/u-sethbacon) and [TedHinklater](https://github.com/tedhinklater) for their take on the [Jellyfin-Featured-Content-Bar](https://github.com/tedhinklater/Jellyfin-Featured-Content-Bar).
|
|
|
|
Here I present my version with some code improvements, loading optimizations, and security enhancements. Works best with the [Zombie theme](https://github.com/MakD/zombie-release) (_Shameless Plug_ `@import url(https://cdn.jsdelivr.net/gh/MakD/zombie-release@latest/zombie_revived.css);`, visit the repo for more color schemes).
|
|
|
|
|
|
> <ins>**Before Installing, please take a backup of your index.html file**<ins>
|
|
|
|
<details>
|
|
<summary> Desktop Layout </summary>
|
|
|
|
|
|
|
|
</details>
|
|
|
|
<details>
|
|
|
|
<summary> Mobile Layout </summary>
|
|
|
|
|
|
|
|
</details>
|
|
|
|
|
|
# Prepping the files
|
|
<details>
|
|
|
|
<summary>index.html</summary>
|
|
|
|
1. Navigate to your `jellyfin-web` folder and search for the file index.html. (you can use any code editor, just remember to open with administrator privileges.
|
|
2. Search for `</head>`
|
|
3. Just before the `</head>`, plug the below code
|
|
```
|
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/MakD/Jellyfin-Media-Bar@latest/slideshowpure.css" />
|
|
<script async src="https://cdn.jsdelivr.net/gh/MakD/Jellyfin-Media-Bar@latest/slideshowpure.js"></script>
|
|
```
|
|
</details>
|
|
|
|
And that is it. Hard refresh your web page (CTRL+Shift+R) twice, and Profit!
|
|
|
|
# Want a Custom List to be showcased instead of random items??
|
|
|
|
No worries this got you covered.
|
|
|
|
## Steps
|
|
|
|
1. Create a `list.txt` file inside your `avatars` folder.
|
|
2. In line 1 give your list a name.
|
|
3. Starting line 2, paste the item IDs you want to be showcased, one ID per line. For Example :
|
|
|
|
```
|
|
Awesome Playlist Name
|
|
ItemID1
|
|
ItemID2
|
|
ItemID3
|
|
ItemID4
|
|
ItemID5
|
|
```
|
|
The next time it loads, it will display these items.
|
|
|
|
# Uninstall the Bar
|
|
|
|
<details>
|
|
|
|
<summary> Roll Back </summary>
|
|
|
|
Restore the `index.html` file / remove the lines added and you are good to go!!!
|
|
|
|
</details>
|
|
|
|
|
|
## License
|
|
|
|
[](LICENSE)
|
|
|
|
|
|
This project is licensed under a DBAD license prohibiting any commercial use or redistribution.
|
|
All modifications must be contributed back to this repository.
|
|
Attribution to the original author (MakD) is required in any use or derivative work.
|
|
|
|
Please take a look at the [LICENSE](LICENSE) file for full terms.
|
|
|
|
</details>
|