Skip to content

v0.1.0 GUI polish: branded header, footer, comet, in-app help, reconnect - #4

Merged
Osiris-DevWorks merged 1 commit into
mainfrom
feature/v0.1.0-polish
May 7, 2026
Merged

Osiris-DevWorks merged 1 commit into
mainfrom
feature/v0.1.0-polish

Conversation

@Osiris-DevWorks

Copy link
Copy Markdown
Owner

Summary

A pile of UX polish on top of the v0.1.0 GUI shipped in PR #3. All changes are GUI/installer-side except for two main.py touches (reconnect refactor + on_connect ready trigger). The bot's runtime behavior in Docker / Railway is unchanged.

What's new

  • Branded header — Hyperspace Race Expanded Bold font (bundled), `SUPER TTS` title + `YOUR VOICE ON DISCORD` tagline stacked, super-tts.png logo top-right inside a theme-colored rounded border.
  • Branded footer — Osiris DevWorks / Discord / PayPal / Venmo cluster matching sc-profile-editor. Eye of Horus glyph pulses while the bot is connected.
  • Status tab merge — old Status + Logs tabs combined; Connect button on the left, status indicator right-justified, embedded log viewer beneath. Status text uses the brand font.
  • Connecting line — a thin theme-colored line grows from the Connect button toward the status dot during connect, snaps + flashes on ready.
  • Reconnect works in-process — `main._build_bot()` constructs a fresh `commands.Bot` per `main()` call. No more "Reconnect requires app relaunch" guard. `on_connect` triggers the GUI observer at gateway-handshake time (~2s earlier than `on_ready`).
  • Slash sync no longer blocks ready — `bot.tree.sync()` runs as a background task, so a 503'd or slow Discord HTTP call can't gate the "Connected" state.
  • Settings tab compaction — inline helper paragraphs collapsed into `?` badges with rich-text tooltips. Log Level removed from Settings (env-editable for power users). Theme renamed "SC Localization Editor" → "Cyan Citizen".
  • Help tab — full DISCORD_SETUP walkthrough, slash command reference for all 18 `/tts` commands, troubleshooting, and storage-locations table.
  • Taskbar icon — generated multi-resolution `super-tts.ico`, set the QApplication icon, and call `SetCurrentProcessExplicitAppUserModelID` so Windows taskbar groups under our app instead of python.exe.

Test status

  • ✅ Dev-mode launch verified end-to-end across multiple connect/disconnect cycles.
  • ✅ Theme swap re-renders title/tagline/logo border/secondary text correctly.
  • ✅ Reconnect within the same process: Disconnect → Connect lands on green again with a fresh Bot instance.
  • ⚠️ Installer .exe rebuild pending on this PR landing — same plan as the v0.1.0 release (replace the existing .exe asset on the v0.1.0 release tag rather than cutting v0.1.1, since the original artifact hasn't been distributed beyond the maintainer).

Plan after merge

Fast-forward main, rebuild `Super-TTS-0.1.0-Setup.exe`, run `gh release upload v0.1.0 ... --clobber` to replace the asset attached to the existing v0.1.0 release.

… in-app help

A pile of UX work on top of the original v0.1.0 GUI. All of it is GUI-side
or installer/asset adjacent — main.py's bot loop logic is unchanged except
for the reconnect refactor and the on_connect ready-trigger hook.

Branding & header
- Brand font (Hyperspace Race Expanded Bold) bundled at
  assets/fonts/HyperspaceRace-ExpandedBold.otf and registered at app
  startup via gui.theme.load_application_fonts().
- Title "SUPER TTS" + tagline "YOUR VOICE ON DISCORD" stacked vertically,
  matching smart-citizen's all-caps + letter-spaced treatment.
- Logo (assets/super-tts.png) pinned top-right inside a theme-colored
  rounded border that re-renders on theme swap.

Branded footer (gui/footer.py, new)
- Osiris DevWorks / Discord / PayPal / Venmo cluster, layout matching
  sc-profile-editor for suite-wide consistency. New 4 assets (osiris-
  devworks.png, discord.png, paypal.png, venmo.png).
- Osiris logo is a stacked widget with assets/osiris-eye-glow.png as the
  overlay; the Eye of Horus glyph pulses (QPropertyAnimation on opacity)
  while the bot is connected. StatusTab.bot_ready / bot_idle signals
  drive Footer.start_pulse() / stop_pulse() from MainWindow.

Status tab + connect UX
- Old "Status" + "Logs" tabs merged into a single Status tab — connect
  button + status indicator on top, embedded LogView (formerly LogTab)
  on the bottom. Connect button on the LEFT, status dot + label
  right-justified.
- Status text uses the brand font.
- A thin theme-colored line grows from the Connect button toward the
  status dot during connecting (gui.status_tab._ConnectingTrack —
  QPropertyAnimation on a custom QPainter widget). Snaps to 100% when
  the gateway handshake lands, flashes the status color, fades out.
- Reconnect now works in-process: main._build_bot() constructs a fresh
  discord.py Bot per main() invocation, and main exposes
  set_ready_observer/get_current_bot for the GUI runner. Removed the
  "Reconnect requires relaunch" guard from StatusTab.

Settings tab
- All inline helper QLabels collapsed into "?" badges with rich-text
  tooltips. Each row now packs [field][?][Show] in one strip.
- Log Level removed (was rarely the limiting factor; .env-editable for
  power users). DEFAULT_TTS_DEVICE / TTS_DEVICE_CHOICES added on the
  settings backend so device is GUI-driven.
- "SC Localization Editor" theme renamed "Cyan Citizen" (internal
  THEME_SCLE key unchanged so existing user prefs keep working).
- Status bar at the window bottom and the "Loaded from..." line are
  removed; footer sits flush with the bottom edge.

In-app Help tab (gui/help_tab.py, new)
- QTextBrowser containing the full DISCORD_SETUP walkthrough, a slash
  command reference for all 18 /tts commands, GUI usage, troubleshooting,
  and "where things are stored" reference. External links route through
  QDesktopServices.

main.py reconnect + responsiveness
- on_connect handler fires the ready observer at the gateway-connected
  moment (matches the "Shard ID None has connected to Gateway" log) so
  the Status tab flips to green ~2s earlier than before. on_ready
  re-fires the observer with bot.user / bot.guilds populated.
- bot.tree.sync() runs as an asyncio.create_task() so a slow / 503'd
  Discord HTTP call can't gate on_ready or any other listener.

Window + taskbar icon
- Generated assets/super-tts.ico (multi-resolution) from super-tts.png.
- gui_main.py sets the QApplication-wide QIcon and calls
  SetCurrentProcessExplicitAppUserModelID before QApplication
  construction so Windows taskbar groups under our app rather than
  python.exe.

Build script
- build_exe.py picks up gui.footer / gui.help_tab / gui.log_view as
  hidden imports and bundles assets/ via --add-data so the fonts and
  branding PNGs ship with the installer.

.gitignore
- /assets/ blanket exclusion replaced with explicit re-includes for
  the named branding assets + the bundled font, so per-user voice and
  model artifacts in assets/ continue to be ignored.

Docs
- DISCORD_SETUP.md tracks the moved Log Level (now Status tab,
  applies live).
@Osiris-DevWorks
Osiris-DevWorks merged commit ee09651 into main May 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant