The Dwarf's Hammer 🔨

Enhanced collection management and content discovery for Jellyfin, tested on 10.11.5

✨ Features

🎬 Upcoming Content

• Upcoming Movies (Coming Soon + Top Rated)
• Upcoming Series :
  • Library: Upcoming episodes + last missing episode
  • Trending
  • Top Rated
• TMDB integration with trailer playback
• Genre filtering
• "In Library" badges

📚 Collection Management

• "No Collection" filter for Movies and Series
• Series Collections tab
• Auto-tagging for non-collection content, required for filtering movies only
• Real-time sync option (admin only)

🔍 Enhanced UI

• Actor/actress Google search from context menu
• Copy title from context menu
• Missing episodes/seasons detection
• Collection links on detail pages

🚀 Installation

Step 1: Install Plugin

1. Dashboard → Plugins → Repositories
2. Click + Add
3. Name: The Dwarf's Hammer
4. URL: https://raw.githubusercontent.com/kamoba/jellyfin-plugin-thedwarfshammer/main/manifest.json
5. Save
6. Go to Plugins catalog tab
7. Find The Dwarf's Hammer
8. Click Install
9. Restart Jellyfin
10. Refresh browser

Step 2: Configure Plugin

1. Dashboard → Plugins → The Dwarf's Hammer
2. Get free TMDB API key from themoviedb.org/settings/api (Optional, needed for Upcomings)
3. Paste API key
4. Click Save
5. Dashboard → Scan All Libraries (or use "Tag Non-Collection Movies" button on Dashboard)
   • This tags movies not in collections with "NotInCollection"
   • Tags auto-update on each full library scan
   • ⚠️ Note: Quick scans (Libraries → Movies → Scan Library) won't update tags - use full scan from Dashboard

Tip: For ongoing updates, enable "Real-time Tagging" in plugin settings to automatically tag new movies as they're added.

Step 3: Install Client Script

Choose one method:

Option A: JavaScript Injector Plugin

1. Install JavaScript Injector from Plugins
2. Restart Jellyfin
3. Download: thedwarfshammer.js
4. Dashboard → Plugins → JavaScript Injector
5. Add script, paste contents, enable, save
6. Refresh browser (Ctrl+F5)

Option B: Manual Injection

Docker:

wget https://raw.githubusercontent.com/kamoba/jellyfin-plugin-thedwarfshammer/main/Web/thedwarfshammer.js
docker cp thedwarfshammer.js jellyfin:/jellyfin/jellyfin-web/
docker exec jellyfin sed -i 's|</body>|<script src="thedwarfshammer.js"></script></body>|' /jellyfin/jellyfin-web/index.html
docker restart jellyfin

Linux:

sudo wget -O /usr/share/jellyfin/web/thedwarfshammer.js https://raw.githubusercontent.com/kamoba/jellyfin-plugin-thedwarfshammer/main/Web/thedwarfshammer.js
sudo sed -i 's|</body>|<script src="thedwarfshammer.js"></script></body>|' /usr/share/jellyfin/web/index.html
sudo systemctl restart jellyfin

Or Edit index.html:

Download script in same location then add `<script src="thedwarfshammer.js"></script>` before `</body>`

Option C: Install the File Transformation plugin [TO DO]

⚠️ Re-apply after Jellyfin updates

✅ Done! Refresh browser (Ctrl+F5)

🎯 Usage

• Upcoming Content: Movies/Shows → "Upcoming" tab
• Filter Collections: Filter button → "No collections"
• Missing Episodes: Open any series/season → see missing episodes
• Auto-Tag: Dashboard → "Tag Non-Collection Movies" button (admin only)

💡 Tip: Press Ctrl+F5 (or Cmd+Shift+R on Mac) to refresh cached data (default 1h) and fetch latest upcoming content from TMDB.

🔒 Security

• TMDB API key stored server-side only
• All API calls proxied through plugin
• Role-based access control

🐛 Troubleshooting

Plugin not showing:

docker logs jellyfin | grep -i dwarf

Script not loading:

• Hard refresh (Ctrl+F5)
• Check browser console (F12)

Uninstall If you need to uninstall, it is advisable to first click on “Delete all tags” in the dashboard to avoid leaving orphaned tags (NotInCollection), even if they are harmless.

📜 License

MIT License

🙏 Credits

• Jellyfin
• TMDB API

💬 Support

• GitHub Issues
• r/jellyfin

---

Enjoying this plugin? ⭐ Star the repo!