Aetheris 1.4.6 BUG FIX

Aetheris v1.4.6

Aetheris v1.4.6 is a reliability and bug-fix update focused on Twitch/AetherisBot commands, cloud connectivity, song requests and queue handling, Spotify and YouTube Music Desktop playback, OBS Now Playing, and update reliability.

🔐 Security Verification

Official Aetheris v1.4.6 binaries can be verified using the SHA-256 hashes below.

Aetheris Setup v1.4.6

• SHA-256: D8E71A86ABA4254751CBDBEEE0F1371D92094328B832138BB26CA8AD7B83A168
• VirusTotal: https://www.virustotal.com/gui/file/D8E71A86ABA4254751CBDBEEE0F1371D92094328B832138BB26CA8AD7B83A168

Installed Aetheris.exe

• SHA-256: 7E219AB36B5E852B1FD8D3B4FB22B79787AA2BE5640B9C0FE985527EF5166678
• VirusTotal: https://www.virustotal.com/gui/file/7E219AB36B5E852B1FD8D3B4FB22B79787AA2BE5640B9C0FE985527EF5166678

Windows SmartScreen: Aetheris is not currently code-signed, so Windows may display an "Unknown Publisher" warning. This does not mean the installer is malicious. You can verify your download against the SHA-256 hash published above.

🛠 What's New

💬 Twitch Commands & AetherisBot

• Fixed an issue that could cause Twitch commands to reach Aetheris while their responses were silently suppressed.
• Improved Twitch live, offline, and unknown stream-state handling used to determine whether AetherisBot should respond.
• Improved connection/readiness information so Aetheris more clearly distinguishes being connected from actually being allowed to send chat responses.
• Improved malformed cloud-message handling to prevent invalid messages from disrupting the connection.

☁️ Cloud Connection Reliability

• Fixed overlapping cloud connection attempts that could leave an earlier connection attempt waiting or produce inconsistent authentication results.
• Added cloud WebSocket keepalive handling to reduce unexpected disconnects caused by idle connections.
• Improved cleanup of connection attempts, timers, sockets, and reconnect behavior.

🎵 Song Requests & Up Next

• Fixed rapid or repeated approval of the same request potentially enqueueing the request more than once.
• Added in-flight request protection so repeated approval actions share the same request operation.
• Fixed Up Next matching incorrectly falling back to song metadata when two tracks had conflicting Spotify or YouTube IDs.
• Improved request failure handling so unsuccessful requests are not incorrectly counted as completed.

▶️ YouTube Music Desktop

• Fixed failed YTMD enqueue operations incorrectly completing and removing song requests.
• Failed requests now remain available instead of being treated as successfully queued.
• Improved YTMD connection indicators so saved Companion credentials are no longer treated as an active player connection.
• Improved automatic recovery when the YTMD Companion endpoint becomes available again.
• Fixed paused REST fallback state incorrectly scheduling an end-of-track song switch.

🟢 Spotify

• Fixed stale Spotify Now Playing information remaining visible after Spotify successfully reports that nothing is currently playing.
• Improved source handling so clearing Spotify playback does not incorrectly clear another active playback source.
• Preserved Now Playing state during transient Spotify API errors rather than treating temporary failures as stopped playback.

📺 OBS Now Playing Overlay

• Fixed hidden progress information reappearing inside the overlay badge.
• Fixed the "Nothing Playing" overlay unnecessarily rebuilding its DOM multiple times per second.
• Improved playback-position synchronization between Aetheris and the standalone OBS overlay.
• Improved elapsed-time and progress-bar updates without unnecessarily rebuilding the full overlay.
• Reduced unnecessary animation restarts during routine playback progress updates.
• Improved overlay behavior during seeks, rewinds, track changes, reconnects, and state refreshes.

🔄 Updates & Reliability

• Improved hot-patch rollback behavior when an update fails during activation.
• Failed activations now make a better effort to restore the previous working runtime instead of leaving Aetheris in a partially updated state.
• Improved update-state cleanup and activation handling.

💾 Backup & Restore

• Corrected Full Setup Backup security wording to more accurately describe how exported credentials are protected.
• Backup files containing setup credentials should still be treated as sensitive files.

⚠️ Known Issues

• Consecutive identical queued tracks can still present an edge case when Aetheris determines whether a playback sample represents a new playback instance.
• A failed delayed YTMD end-of-track handoff can still cause the held request to be lost.

These issues are being tracked separately rather than delaying the other reliability improvements included in v1.4.6.

🔄 Compatibility

Aetheris v1.4.6 preserves the existing standalone OBS overlay architecture, Browser Source URLs, overlay customization, Spotify/YTMD integrations, and existing user settings.

📦 Updating

Existing users can install Aetheris v1.4.6 over their current Aetheris installation.

Existing settings and configuration should remain intact during the update.

🖤 Thank You

Thank you for your patience, continued support, and for being part of Aetheris.

Every bug report, test, suggestion, and bit of feedback helps make Aetheris better. There's a lot more planned, and your support while the project continues to grow and improve genuinely means a lot.

Thank you for supporting Aetheris. 🖤

Aetheris 1.4.5

Aetheris v1.4.5

🔐 Security Verification

Installer

File: Aetheris-Setup-1.4.5.exe

SHA-256
20736196BFE23F9C66199883C6873A7B97F7B49B487403220DF8A924A43D3B1E

VirusTotal
https://www.virustotal.com/gui/file/20736196BFE23F9C66199883C6873A7B97F7B49B487403220DF8A924A43D3B1E

Installed Application

File: Aetheris.exe

SHA-256
7F9951992375C59320B0685E1C804A3FB4D0DC53039B89358ADC08C1A919C422

VirusTotal
https://www.virustotal.com/gui/file/7F9951992375C59320B0685E1C804A3FB4D0DC53039B89358ADC08C1A919C422

The installed executable hash identifies the exact Aetheris.exe
checked during release verification. VirusTotal links are permanent
file reports based on each file's SHA-256.

---

✨ What's New

🎥 Rebuilt OBS Now Playing Overlay

Aetheris v1.4.5 introduces a major rebuild of the OBS Now Playing
overlay system.

The overlay now runs through its own dedicated lightweight runtime
instead of relying on the main Aetheris interface to render the
Now Playing display.

This separates the OBS overlay from the main application UI and
provides a cleaner foundation for future overlay features.

⚡ Improved Overlay Synchronization

The new overlay uses realtime playback events alongside an
authoritative state synchronization system.

This improves:

• Track-change responsiveness
• Skip detection
• Seek/rewind synchronization
• Pause and resume behavior
• Recovery after temporary connection interruptions
• Browser Source refresh behavior
• Overall Now Playing reliability

The overlay can also retrieve the current playback state immediately
when it loads instead of waiting for the next playback event.

🔄 Improved Reconnect & Recovery

The standalone overlay now includes improved event-stream reconnect
handling and heartbeat support.

If the realtime connection is interrupted, Aetheris can automatically
recover and synchronize the overlay with the current playback state.

This helps prevent the overlay from becoming delayed, stuck on an old
track, or remaining on "Nothing Playing" while music is active.

💿 Fixed Overlay Animation Restarts

Fixed an issue introduced during the standalone overlay rebuild where
frequent playback-state updates could repeatedly restart visual
animations.

The vinyl animation can now spin continuously, and scrolling track
titles can complete their animation normally.

Playback progress and timing updates no longer unnecessarily rebuild
the entire overlay.

🩹 Expanded Hot-Patch Support

The Aetheris hot-patch system now supports the new standalone OBS
overlay resources.

Future fixes limited to the standalone overlay HTML or JavaScript can
be delivered through Aetheris hot patches without requiring an entire
new installer.

Hot-patch safety rules remain in place so changes involving protected
core application files still require a full Aetheris release.

---

🛠 Reliability

• Improved OBS playback-state consistency
• Improved recovery from stale overlay state
• Reduced unnecessary overlay rendering
• Preserved fast playback-state synchronization without repeatedly
  resetting visual elements
• Improved separation between the main Aetheris UI and OBS overlay
  runtime

---

📦 Updating

Existing users can install Aetheris v1.4.5 directly over their
current Aetheris installation.

Your existing Aetheris configuration and settings should remain intact.

For this release, install the full v1.4.5 installer. Future compatible
overlay-only fixes can be delivered through the Aetheris hot-patch
system.

---

🛡 Windows SmartScreen

Aetheris is currently distributed without a commercial code-signing
certificate.

Because of this, Windows SmartScreen may display an
"Unknown publisher" warning when launching the installer.

You can verify your download using the SHA-256 hashes and VirusTotal
reports provided above.

Aetheris 1.4.4

Aetheris v1.4.4

Aetheris v1.4.4 focuses on reliability, OBS overlay performance, Twitch/AetherisBot connectivity, and lays the groundwork for delivering smaller fixes without requiring a full installer update every time.

🔐 Security Verification

Installer

File: Aetheris-Setup-1.4.4.exe

SHA-256:
9BFCE7C317B91A35EA580F01F9FE43C029569CD9F6007457BF1A487D736AA7E0

VirusTotal:
https://www.virustotal.com/gui/file/9BFCE7C317B91A35EA580F01F9FE43C029569CD9F6007457BF1A487D736AA7E0

Installed Application

File: Aetheris.exe

SHA-256:
3BF7DE703A24A6AC2E136387E8B1941ED0961A7E4C7F2CD61790E818F53DFDD0

VirusTotal:
https://www.virustotal.com/gui/file/3BF7DE703A24A6AC2E136387E8B1941ED0961A7E4C7F2CD61790E818F53DFDD0

VirusTotal scans were completed for both files. The hashes above identify the exact installer and installed executable verified for this release.

✨ What's New

🔄 New Hot-Patch Update Foundation

Aetheris now includes the foundation for a GitHub commit-driven hot-patch system.

This allows compatible fixes to be delivered between full releases without requiring users to download and reinstall Aetheris every time.

When a compatible patch is active, Aetheris can display the version as:

v1.4.4 patch

The system is designed to distinguish between files that are safe to patch and core application changes that still require a full installer update.

This is the foundation for faster and smaller Aetheris updates going forward.

🎥 OBS Overlay Improvements

Improved communication between Aetheris and the OBS Now Playing overlay.

The overlay now handles playback updates and synchronization more reliably, reducing cases where OBS could fall behind Aetheris or continue displaying stale playback information.

Additional handling was added for connection recovery and state synchronization so the overlay can recover more cleanly if communication with Aetheris is interrupted.

📋 Improved Copy Buttons

Improved clipboard handling throughout Aetheris.

Copy actions now use the Electron/native clipboard bridge more reliably instead of depending entirely on browser clipboard behavior.

This improves copying for areas including:

• OBS Overlay URL
• Twitch authorization information
• Spotify redirect information
• Connection/debug information

🤖 AetherisBot Cloud Pairing Fix

Updated the AetherisBot server pairing system to match the current desktop authentication protocol.

Fixed an issue where Aetheris could successfully connect to Twitch locally while the AetherisBot cloud connection reported:

AetherisBot returned an invalid pairing secret.

The cloud service now correctly generates and validates desktop pairing secrets.

🔌 AetherisBot Disconnect & Credential Revocation

Added the missing desktop credential revocation endpoint to AetherisBot.

Disconnecting Aetheris can now properly revoke the associated cloud credential and terminate its cloud connection instead of only disconnecting locally.

This also resolves the previous /desktop/revoke 404 response.

🛠️ Reliability Improvements

• Improved OBS playback-state synchronization.
• Improved recovery from interrupted OBS overlay connections.
• Improved native clipboard behavior.
• Improved Twitch/AetherisBot desktop pairing.
• Added proper AetherisBot desktop credential revocation.
• Improved handling of cloud connection state.
• Preserved local Twitch IRC connectivity independently from AetherisBot cloud pairing.
• Updated Aetheris versioning for the v1.4.4 release.
• Added infrastructure for future patch-level updates between full releases.

📦 Updating

Download and run Aetheris-Setup-1.4.4.exe.

Existing settings should remain intact when updating from a previous Aetheris installation.

⚠️ Windows SmartScreen

Because Aetheris is independently distributed and is not currently signed with a commercial Windows code-signing certificate, Windows SmartScreen may display an "Unknown publisher" warning.

If you downloaded Aetheris from the official release, you can verify the installer using the SHA-256 hash provided above before running it.

---

Aetheris v1.4.4

Built for streamers, with more to come. 🎶

Aetheris 1.4.3 Bug Fix

Aetheris v1.4.3

Aetheris v1.4.3 is a reliability-focused release that improves queue synchronization, announcements, backup exports, song-request logging, developer builds, and local update behavior.

🔒 Security Verification

Official Aetheris v1.4.3 files can be verified using the SHA-256 hashes below.

Installer

SHA-256
4867EAA0E73127132F76E8289D0954ECEA6D5978497116E155B07CB683EFAB14

VirusTotal
View installer scan

Installed EXE

SHA-256
5C9B93246EFEB81BCAA9B81D63F0C9C32FFF049516DC07C43A3E1C41D92F8FE5

VirusTotal
View installed EXE scan

---

✨ What's New

• Fixed Spotify queue clearing so Aetheris immediately clears its Dashboard Up Next queue when the Spotify queue is emptied.
• Fixed startup announcements so the Aetheris initialization message is sent after the cloud bridge is authenticated and ready.
• Restored reliable Now Playing announcements for cloud-connected channels.
• Fixed Full Setup and Theme backup exports so the native Windows Save dialog opens correctly.
• Fixed backup file creation after selecting a save location.
• Fixed requested-song logging so new requests continue saving to the daily song request log.
• Improved error-log copy behavior with native clipboard fallback support.
• Updated the Windows build toolchain to electron-builder 26.15.3.
• Updated the application version to v1.4.3.

🎵 Queue & Playback Reliability

• Improved synchronization between Spotify’s active queue and Aetheris’s Up Next queue.
• Prevented stale queued songs from remaining visible after Spotify clears its queue.
• Preserved existing Spotify and YouTube Music Desktop playback behavior.
• Improved cloud startup and Now Playing announcement timing.

💾 Backup & Export Improvements

• Fixed the Full Setup backup export flow.
• Fixed the Theme backup export flow.
• Added reliable native Windows save dialogs for exported backup files.
• Improved export failure reporting when a file cannot be written.

📝 Song Request Logging

• Restored daily requested-song log writing.
• Improved log creation and continuation for new requests.
• Preserved the existing daily log rotation behavior.

🔄 Developer Mode & Updates

• Updated the development build process to electron-builder 26.15.3.
• Improved clean Windows development builds after stale dependency or NSIS state.
• Fixed Developer Mode Update from File installer handoff behavior.
• Improved local installer launching so Aetheris can close before files are replaced.
• Preserved the existing automatic update system for normal releases.

🛠️ Stability & Reliability

• Improved cloud bridge startup sequencing.
• Improved announcement delivery after Twitch authentication.
• Improved native clipboard and error-log handling.
• Refreshed npm dependency installation for reproducible Windows builds.
• Performed a stability pass across queue, backup, logging, update, and startup systems.

---

Updating

Existing users can update through Aetheris when the update becomes available or download the latest installer directly from this GitHub release.

Windows SmartScreen

Because Aetheris is independently distributed and is not currently code-signed with a commercial certificate, Windows SmartScreen may display an “Unknown publisher” warning.

If the installer was downloaded from the official Aetheris GitHub release, verify its SHA-256 hash against the value published above before running it.

Thank you for using Aetheris! 💜

1.4.2 Bug Fix

Aetheris v1.4.2

Aetheris v1.4.2 is a stability-focused patch that improves Twitch/AetherisBot reliability, command handling, local updates, and application lifecycle behavior.

🔒 Security Verification

Official Aetheris v1.4.2 files can be verified using the SHA-256 hashes below.

Installer

SHA-256
620E09B517B5E6856123E594CFE945A4698BA9B8FBBD9AEDD8CF5CB8BF397B8E

VirusTotal
https://www.virustotal.com/gui/file/620E09B517B5E6856123E594CFE945A4698BA9B8FBBD9AEDD8CF5CB8BF397B8E

Installed EXE

SHA-256
C5592E8F41C9C776FFCCD288038FD775411B5C4037D593077E3F81B6E280BB20

VirusTotal
https://www.virustotal.com/gui/file/C5592E8F41C9C776FFCCD288038FD775411B5C4037D593077E3F81B6E280BB20

---

✨ What's New

• Improved AetherisBot cloud connection stability.
• Improved Twitch live/offline detection through the AetherisBot backend.
• Improved Twitch command handling for custom and migrated command settings.
• Custom commands are now automatically normalized, preventing commands such as !sr, !ssr, Now Playing, and Queue commands from silently failing when an older saved setting is missing the !.
• Improved AetherisBot EventSub subscription handling and multi-channel reliability.
• Improved Twitch disconnect and credential cleanup behavior.
• Added a local disconnect fallback if the AetherisBot backend cannot complete a revoke request.
• Improved Developer Mode launcher compatibility with both per-user and Program Files installations.
• Removed Electron's hidden native menu from appearing when pressing Alt.

🛠️ Stability & Reliability

• Fixed AetherisBot WebSocket reconnect and teardown race conditions.
• Improved handling of WebSockets that are still connecting during reconnect or shutdown.
• Added safer application shutdown cleanup for AetherisBot, YouTube Music Desktop, Spotify OAuth, OBS relay, and reconnect/retry timers.
• Improved system tray initialization with automatic retries.
• Prevented Aetheris from becoming an invisible background process if tray initialization fails.
• Prevented duplicate Electron listeners from accumulating if the main window is recreated.
• Improved developer build cleanup and recovery from NSIS/electron-builder spawn UNKNOWN failures.

🔄 Updates

• Fixed Developer Mode Update from File hanging during installer handoff.
• Improved local installer launching so Aetheris exits before the installer attempts to replace application files.
• Preserved the existing automatic update system for normal releases.

🎵 Twitch & Song Requests

• Fixed an issue where Twitch messages could successfully reach Aetheris but custom request commands would not match.
• Improved compatibility with command settings carried forward from previous Aetheris versions.
• Improved AetherisBot EventSub routing for multiple connected Twitch channels.
• Improved stream-status synchronization between AetherisBot and the desktop app.
• Improved cloud command and reply handling while a broadcaster is live.

🧹 Internal Improvements

• Removed temporary command-diagnostic instrumentation used during v1.4.2 development.
• Consolidated command normalization to reduce inconsistent command handling.
• Hardened connection, timer, tray, updater, and shutdown lifecycle management.
• Performed a stability audit across the Aetheris desktop application while preserving existing Spotify and YouTube Music Desktop behavior.

---

Updating

Existing users can update through Aetheris when the update becomes available or download the latest installer directly from this GitHub release.

Windows SmartScreen

Because Aetheris is independently distributed and is not currently code-signed with a commercial certificate, Windows SmartScreen may display an "Unknown publisher" warning.

If the installer was downloaded from the official Aetheris GitHub release, verify its SHA-256 hash against the value published above before running it.

Thank you for using Aetheris! 💜

Aetheris 1.4.1 Bug Fix

Aetheris v1.4.1

This patch focuses on playback reliability, command customization, OBS overlay improvements, and a smoother update experience.

🔒 Security Verification

All official Aetheris release files can be verified before installation.

Installer SHA-256:
AFA8F24588A7D13297177F4BC8F484EC64137FF9071F67DCBF31BAD51AFCF4F2

Installed EXE SHA-256:
CEFD87C6CC3958FD98AB7D3E89B9E98F115DBD88229751772E4DA9E4CD500E13

VirusTotal:

• Installer: https://www.virustotal.com/gui/file/AFA8F24588A7D13297177F4BC8F484EC64137FF9071F67DCBF31BAD51AFCF4F2
• Installed EXE: https://www.virustotal.com/gui/file/CEFD87C6CC3958FD98AB7D3E89B9E98F115DBD88229751772E4DA9E4CD500E13

What's New

• Fixed Spotify playback controls incorrectly reporting failures when Spotify returned a successful HTTP 200 response with an empty or non-JSON body.
• Fixed false "Could not pause/play/skip — no connected player to control" messages when Spotify had actually accepted the command.
• Improved Spotify Play, Pause, Skip/Next, and Previous response handling.
• Added customizable playback command names for Spotify.
• Added customizable playback command names for YouTube Music Desktop.
• Spotify and YouTube Music Desktop commands can now be configured independently.
• Custom service command names are preserved through settings and Full Setup backup/restore.
• Improved the OBS Now Playing overlay behavior and reliability.
• Fixed Developer Mode Update from File failing with spawn UNKNOWN.
• Improved local update installer launching on Windows while preserving Developer Mode restrictions.

Updating

Existing Aetheris installations can use Check for updates from the About page.

New installations can download the latest installer from the Aetheris website or this GitHub release.

Aetheris 1.4.0

Aetheris v1.4.0

☁️ Major Cloud Infrastructure Upgrade

Aetheris has received its largest infrastructure upgrade yet.

Twitch song requests are now powered by the new AetherisBot cloud infrastructure. Instead of requiring each streamer to configure and run their own Twitch bot connection, Aetheris now uses a centralized cloud service to securely connect Twitch chat with the Aetheris desktop app.

What's New

• AetherisBot now handles Twitch chat requests through the cloud.
• Added Twitch EventSub integration for reliable chat events.
• Added streamlined browser-based Twitch authorization and pairing.
• Viewers' requests are securely routed from Twitch → AetherisBot → your Aetheris desktop app.
• Aetheris processes Spotify or YouTube Music playback locally and sends the result back through AetherisBot.
• Added cloud-based Twitch live/offline detection.
• Bot messages are automatically suppressed while the streamer is offline unless offline testing is enabled.
• Added automatic Twitch OAuth validation and token refresh.
• Added WebSocket heartbeat/reconnection handling for improved cloud reliability.
• Hardened desktop pairing, credential rotation, disconnect, and server-side revocation.
• Normal users no longer need to configure a separate Twitch bot username or OAuth token.

🛡️ Security & Release Verification

v1.4.0 Release Verification

Aetheris v1.4.0 release files have been integrity checked and submitted to VirusTotal for independent security scanning.

Installer SHA-256

BD5B5BED5E7A8679BD439E5E81B8B19694F406E13E1903C54AE8520AD56EEC1D

Installer VirusTotal

https://www.virustotal.com/gui/file/BD5B5BED5E7A8679BD439E5E81B8B19694F406E13E1903C54AE8520AD56EEC1D

Installed Aetheris.exe SHA-256

2B23E55BD1C09CC89C1FB05F513D86B2AB1F6B1501E690CF08A112EC92B79633

Installed Aetheris.exe VirusTotal

https://www.virustotal.com/gui/file/2B23E55BD1C09CC89C1FB05F513D86B2AB1F6B1501E690CF08A112EC92B79633

Security Hardening

Aetheris v1.4.0 includes a major security-hardening effort across both the desktop application and AetherisBot infrastructure.

• Sensitive credentials are protected using Electron safeStorage instead of normal browser storage.
• Full Setup backups now securely protect sensitive configuration data.
• Added stricter IPC, configuration import, navigation, permission, and external-link protections.
• Added additional Electron browser security restrictions.
• Added secure/private atomic storage for sensitive local files.
• Hardened AetherisBot pairing, OAuth, EventSub, WebSocket, request validation, payload limits, and rate limiting.
• OBS integration now uses a secure localhost relay instead of exposing service credentials in the overlay URL.
• Added additional protections against malformed or malicious configuration and network data.
• Aetheris release builds undergo SHA-256 integrity verification.
• Release installers are checked with VirusTotal before public release.

🎵 Spotify Improvements

• Improved Spotify playback-control reliability.
• Playback commands such as !skip now explicitly target an available Spotify Connect device instead of depending entirely on Spotify's active-device state.
• Improved Spotify queue/playback behavior when Spotify is connected but doesn't report the expected active-player state.

🟣 Twitch Improvements

• Redesigned the normal Twitch connection experience around AetherisBot cloud pairing.
• Improved Connect, Reconnect, Disconnect, and Re-authorize state handling.
• Fixed cases where Aetheris incorrectly continued showing Re-authorize Twitch after authorization was healthy.
• Added an Advanced section for testing and legacy/fallback Twitch options.
• Improved startup cloud authentication and connection-state reporting.

🔴 YouTube Music Desktop

• Preserved and improved Companion Server integration for local YouTube Music Desktop playback.
• Maintained realtime playback tracking and Twitch command support alongside the new cloud Twitch infrastructure.

🔗 Connection Status Improvements

• Fixed cases where the Settings connection cards could incorrectly show services as disconnected while the sidebar showed the correct state.
• Twitch, Spotify, YouTube, and YTMD status displays now stay synchronized more reliably.
• Improved AetherisBot cloud connection state during application startup.

✨ What's New & Version Display

• Restored the version / What's New control underneath the Aetheris name.
• Fixed cases where the version pill could appear blank, tiny, or disappear.
• Preserved clickable What's New patch notes.
• Preserved keyboard accessibility.
• Restored the animated theme-colored border when new release notes haven't been viewed.
• Updated Aetheris for the v1.4.0 release.

🖥️ Reliability & Desktop Improvements

• Improved Windows system-tray behavior and packaged-app reliability.
• Improved packaged UI resource loading.
• Preserved secure OBS Now Playing overlays.
• Improved diagnostics and error reporting around cloud connections.
• Numerous smaller stability, state-management, and reliability fixes throughout Aetheris.

---

Aetheris v1.4.0 represents the transition from a locally configured Twitch song-request bot into a centralized, cloud-connected Aetheris platform — while keeping Spotify and YouTube Music playback safely on your own PC.

Support & Feedback
[nyxia.codeservice@gmail.com](mailto:nyxia.codeservice@gmail.com)

Aetheris 1.3.0

Aetheris v1.3.0

Aetheris v1.3.0 is a major update focused on song-request reliability, playback tracking, YouTube Music Desktop integration, OBS presentation, customization, diagnostics, and Windows usability.

🔐 Release Verification

The final Windows installer and installed Aetheris executable were both submitted to VirusTotal as part of the v1.3.0 release verification process.

Installer

File: Aetheris-Setup-1.3.0.exe

SHA-256:
7F949AFB4E8E5E3D43911EBEB2C12D537ABBE580DAC2A65A9A9846CC712A16A8

View Installer on VirusTotal

Installed Application

File: Aetheris.exe

SHA-256:
C344CB8DE7662AA6D6B8975B1783F077C6B4794ABBD1D730DFD85E2E514435FB

View Installed Application on VirusTotal

The SHA-256 hashes above identify the exact files checked during this release verification.

---

What's New

🎵 Song Requests & Playback

• Expanded automatic request handling and safer request fallbacks.
• Improved Up Next behavior, queue persistence, and playback tracking.
• Added requested-song logging for easier troubleshooting and review.
• Improved playback source handling and overall playback reliability.

🎶 YouTube Music Desktop

• Improved Companion Server realtime connection handling.
• Better offline and reconnect behavior.
• Improved playlist rejoining and shuffle behavior.
• More reliable startup and playback-state tracking between Aetheris and YTMD.
• Improved handling when YTMD or its Companion Server is unavailable.

💬 Twitch

• Aetheris can remain connected while the Twitch channel is offline.
• Bot replies and announcements are suppressed while offline by default.
• Added an optional testing mode to allow bot messages while offline.
• Improved Twitch live-status detection and logging.
• Improved startup reliability so Twitch issues don't prevent other Aetheris services from starting.

📺 OBS Overlay

• Improved packaged-build overlay resource handling.
• Improved OBS preview matching and sizing.
• Improved true 1:1 overlay presentation.
• Improved scrolling behavior for long song titles.
• Better handling of short titles without unnecessary scrolling.
• Improved packaged-resource handling for the external OBS overlay.

🎨 Customization

• Added a redesigned Aetheris color picker.
• Added saturation/value selection and hue adjustment.
• Added exact editable HEX color values.
• Added a vertical brightness control directly inside the color picker.
• Added a new default theme for fresh installations.
• Improved theme-aware update indicators.

🖥️ Interface & Setup

• Redesigned the Commands section.
• Streamlined YouTube setup and tutorial flow.
• Improved the compact Now Playing area.
• Improved statistics and readiness information.
• Cleaned up Twitch OAuth and related settings behavior.
• Added support/feedback information to What's New.

🔽 Windows System Tray

• Closing the Aetheris window now sends it to the Windows system tray instead of immediately shutting down.
• Clicking the tray icon restores Aetheris.
• Added Open Aetheris and Exit Aetheris tray options.
• Exit Aetheris fully closes the application and stops background request handling.
• Added packaged-build tray icon handling.
• Tray initialization can no longer prevent the main Aetheris window from opening if the tray encounters a problem.

🛠️ Reliability, Diagnostics & Developer Tools

• Expanded runtime diagnostics and error logging.
• Improved packaged-resource handling.
• Improved Developer Mode and local update support.
• Improved startup error isolation.
• Added additional safeguards around renderer and integration startup.
• Fixed a packaged-build issue that could cause Aetheris to open to a blank window because the main UI resource wasn't available at the expected runtime path.

---

📧 Support / Feedback

nyxia.codeservice@gmail.com

Aetheris 1.2.2

What's new

• Fixed the YouTube API tutorial — clicking the tutorial link in an installed version of Aetheris no longer causes Windows to look for the HTML file inside Electron's app.asar archive.

• Tutorial is now packaged correctly — the YouTube API setup guide is stored as a real resource outside app.asar, allowing Windows to open it normally in your default browser.

• Works in development and installed builds — the tutorial link now works whether Aetheris is launched with npm start or from a packaged installation.

Aetheris 1.2.1

What's new

• Full setup export & import — added Export all and Import all to Settings so you can move your Aetheris setup to a new PC or clean installation with one JSON file. It carries over Twitch settings and bot credentials, Spotify setup and authorization tokens, your YouTube API key, YouTube Music Desktop settings/token, return-playlist options, theme, and OBS overlay customization.
• Safer setup backups — full setup exports intentionally leave out request queue, recently played/history, and current now-playing data. Aetheris also warns that the backup contains readable API keys and authorization tokens, so the file should be kept private.
• Customization export stays separate — the existing customization-only export/import is still available in the Customization tab for transferring or sharing just your theme and OBS overlay settings without account credentials.
• Fixed the YouTube API tutorial — the bundled aetheris-youtube-api-setup.html guide is now included in packaged builds and the click here link under the YouTube API key field opens the local tutorial correctly from the installed desktop app.