Releases: DreadHeadHippy/ampdeck
DEPRECATED — Ampdeck has moved!
This project is no longer maintained.
The new version, Ampdeck+, is here:
https://github.com/DreadHeadHippy/AmpdeckPlus
Ampdeck v1.3.1
Ampdeck v1.3.1 - Bug Fixes & Polish
🐛 Bug Fixes
This patch release fixes four issues discovered in v1.3.0:
Touch Strip Text Color
Fixed touch strip displaying content (track/artist/album names) in grey instead of the user's chosen text color. The text now properly displays in the chosen color (white, orange, amber, etc.) to match the labels when playing, and both dim to grey when paused.
Rating Button Text Positioning
Fixed vertical alignment of numeric rating displays. Text at larger font sizes was appearing too high on the button. Now properly centered regardless of font size for both "Numeric Only" and "Both" display modes.
Rating Loss on Quick Track Changes
Fixed ratings being lost when switching tracks too quickly. Ratings now save immediately when you change tracks, even if you skip within the 2-second debounce window. Previously, if you rated a track and switched songs within 2 seconds, the rating wouldn't save.
Rating Button API Efficiency
Fixed the rating button making an API call on every press. Now uses the same 2-second debounce as the dial to prevent API spam when clicking rapidly through ratings. Display updates immediately, saves are batched intelligently.
🚀 Performance
No performance impact from these fixes:
- Rating saves remain debounced (2 seconds) to prevent API spam while adjusting the dial on a single track
- Immediate flush on track change ensures ratings save (one API call per track—the minimum needed)
- No additional polling overhead—efficient use of existing 1-second timeline poll
📦 Installation
For Existing Users (Recommended)
Download and run install.bat (Windows) or install.sh (Mac/Linux) from this release:
- Close Stream Deck completely (right-click tray icon → Quit)
- Download
install.bat(Windows) orinstall.sh(Mac/Linux) - Run the installer
- Start Stream Deck
Your settings will be preserved.
For New Users
Download and double-click com.dreadheadhippy.ampdeck.streamDeckPlugin
Stream Deck will install the plugin automatically.
📝 Full Changelog
See CHANGELOG.md for complete technical details.
🙏 Credits
Big thanks to @rackemrack for creating this awesome plugin!
Contributions by @DreadHeadHippy
Ampdeck v1.2.0
Ampdeck v1.2.0 - Star Ratings & Security Enhancements
🌟 What's New
Star Rating System
Rate your tracks directly from your Stream Deck+ dial!
- Rotate to rate: Turn the dial to adjust star ratings (0-5 stars)
- Half-star or full-star: Choose your preferred rating increment
- Visual feedback: See stars update in real-time on the touch strip
- Smart saving: Auto-saves after 2 seconds to prevent excessive API calls
To use: Set dial action to "rating" in the Now Playing Strip settings.
🔒 Security Improvements
This release includes important security enhancements:
- Enhanced API authentication and credential handling
- Improved input validation for server endpoints
- Strengthened connection security requirements
- Better error messages and user feedback
Note: Remote Plex servers now require HTTPS connections. Local and home network setups (192.168.x.x, 10.x.x) continue to work as before.
📦 Installation
New simplified installation!
- Download
com.rackemrack.ampdeck.streamDeckPluginbelow - Double-click the file
- That's it! Stream Deck handles the rest.
Your settings are automatically preserved when updating.
🎯 Other Improvements
- Simplified installation process (just double-click!)
- Fixed overlay timing issues on touch strip
- Improved error handling and validation feedback
- Better code organization and documentation
- Enhanced overall stability
⚠️ Important Notes
HTTPS Requirement for Remote Servers
If you connect to your Plex server over the internet (not on your local network), you'll need to use HTTPS:
- ✅ Correct:
https://plex.example.com:32400 - ❌ Will not work:
http://remote-server.com:32400
Local network users are not affected - these still work fine:
- ✅
http://localhost:32500(Plexamp player) - ✅
http://192.168.1.100:32400(local Plex server) - ✅
http://10.0.0.50:32400(home network)
This change improves security for remote connections.
🐛 Bug Fixes
- Fixed timing issues with touch strip overlays
- Improved state management for visual feedback
- Enhanced validation prevents invalid configurations
- Better error messages guide troubleshooting
📝 Full Changelog
- Add star rating system with dial controls
- Implement half-star and full-star rating modes
- Add visual overlay feedback for ratings
- Enhance API security and authentication practices
- Improve input validation for URLs
- Strengthen connection security requirements
- Simplify installation with .streamDeckPlugin file
- Fix overlay timing bugs
- Improve error handling throughout
- Update documentation
🙏 Credits
Star rating feature and security improvements by @DreadHeadHippy
Original Ampdeck plugin by @rackemrack
📥 Download
Download streamdeck plugin.
Double-click to install. Stream Deck will handle everything automatically!
Questions or issues? Please open an issue on GitHub or reach out!
Enjoy rating your Plexamp tracks! ⭐⭐⭐⭐⭐
Contributors
Assets 2
Ampdeck v1.3.0
Ampdeck v1.3.0 - Rating Button & Smart Caching
🎉 What's New
Rating Button
A new Rating button action displays the current track's star rating on any Stream Deck key. Tap to cycle through ratings with three display styles:
- Stars Only: ★★★★☆ (classic star display)
- Numeric Only: 4.5 (big, bold number)
- Both: 4.5/5 (number with scale)
Fully configurable with font size (32-56px), rating mode (half-star or full-star increments), and display style options. Works on all Stream Deck models with LCD keys!
Critical Bug Fix: Rating Persistence
Fixed a major issue where ratings would save successfully but then revert to zero after a few seconds. Implemented smart per-track caching that handles Plex's server-side cache delays properly. Ratings now persist correctly without reverting.
UX Improvements
- Removed "SAVED!" confirmation overlay for rating changes (ratings persist visibly, no confirmation needed)
- Rating changes are now silent on success (errors still shown)
- Cleaner, less intrusive experience
📦 Installation
For Existing Users (Recommended)
Download and run install.bat (Windows) or install.sh (Mac/Linux) from this release:
- Close Stream Deck completely (right-click tray icon → Quit)
- Download
install.bat(Windows) orinstall.sh(Mac/Linux) - Run the installer
- Start Stream Deck
Your settings will be preserved.
For New Users
Download and double-click com.rackemrack.ampdeck.streamDeckPlugin
Stream Deck will install the plugin automatically.
🔧 What's Fixed
- Rating Persistence: Ratings no longer revert to zero due to Plex cache delays
- Smart Caching: Per-track rating cache ensures local changes aren't overwritten by stale server data
- Cross-Source Protection: Rating updates protected across timeline polls, metadata fetches, and server fallback
📝 Full Changelog
See CHANGELOG.md for complete technical details.
🙏 Credits
Big thanks to @rackemrack for creating this awesome plugin!
Contributions by @DreadHeadHippy