Theme API 2.0 and the editor. The launcher now renders declarative themes with layered elements, groups, masks, filters, transforms, text and data layers, gauges, tickers, clocks, countdowns, media, Lottie, fonts, icon families, 3D cursor parallax, particle fields, logic rules, and sandboxed scripts. Custom Svelte layers are supported through an in-app Monaco editor. The standalone editor includes a live 1000×650 stage, multi-select, snapping, inspectors, previews, package import/export, backups, and trust prompts.
The Community Workshop. Themes can be browsed, searched, tagged, sorted, liked, downloaded, forked, reported, and installed in batches. Authenticated users can upload themes in chunks, publish new versions, and go through a pre-publication review queue. Moderators get approvals, takedowns, hidden-theme handling, and trash/restore/permanent-delete flows.
Discord Activity presence. Presence editing is now a full studio, opened from Settings → Integrations → Customize Activity. It has four tabs: Idle, In-Game, Buttons, and Presets. Idle covers activity text, media/badge tooltips, avatar overlays, and elapsed time. In-Game covers gameplay text, beatmap artwork, player badges, and the live match timer. Buttons has separate idle and in-game primary buttons plus a shared community/profile button; The editor includes a live Discord profile mockup that can switch between idle and gameplay, simulate beatmaps/actions, zoom in and out, and either focus fields in edit mode or test buttons in preview mode.
A redesigned Settings menu. Settings is now a tabbed hub with six sections: Gameplay, Appearance, Integrations, Installation, Diagnostics, and Logging. Each tab has its own description, an auto-save indicator, and a status/quick-actions sidebar. Gameplay covers patching and the Windows patcher stream; Appearance covers the Lazer-style cursor, cursor smoothing, reduced motion, and low-latency game optimization; Integrations covers Discord presence, Activity customization, and anonymous tracking; Installation covers the osu! path and Windows OpenTabletDriver; Diagnostics and Logging open the dedicated panels described below.
Logs, diagnostics, and notifications. Launcher, osu!, and patcher output rotates at 5 MiB and is archived into one ZIP per session, with the newest five bundles kept. The new log viewer lists bundles by date and size, switches between the three streams, filters lines, shows errors only, copies the filtered output, refreshes the list, and opens the logs folder. Diagnostics checks the launcher and platform, the osu! path/version/integrity/write access, patcher files and stream, the logs path, and platform tools: Wine prefix/runtime/.NET 8/FFmpeg on macOS, osu-winello/wmctrl on Linux, and the .NET 8 runtime on Windows. It can copy a support report and jump into Repair setup. Notifications now have full details, actions, unread counts, mark-read/mark-all, pagination, and links back to Workshop themes.
Platform integration. macOS gets Wineskin/Whisky/CrossOver detection, font-registry cleanup, updater-marker cleanup, patcher compatibility patching, native window rounding, and the loopback media server with FFmpeg transcoding for large theme videos. Windows gets OpenTabletDriver automation and the low-latency game optimization mode. Linux supports osu-winello and wmctrl, stays on the stable patcher stream, and remains partially supported as described in the README.
Launcher polish and setup. The setup wizard is now a three-step flow: welcome, osu! location, and personalization. It auto-detects installations (including macOS wrappers), explains the macOS app-bundle choice, and exposes patching, cursor, reduced-motion, and Discord options in one place. Date/time pickers, context menus, updated dialogs/tooltips/sliders, titlebar/window behavior, section icons, session-scoped editor accordion state, and installed/workshop card entry animations round out the UI work.
Smaller but visible changes. Theme media now handles autoplay/unmute and keeps the volume control available. The theme editor adds detachable header and player-card widgets, banner variants, custom CSS classes, and theme variables. Workshop NSFW previews stay blurred until revealed, and download progress survives tab switches. The heavy editor/Workshop/diagnostics/logs/Presence windows are lazy-loaded with explicit loading states.
Packaging and docs. The branch updates the NSIS/AppImage and macOS app/dmg build configs, the .ezpplauncher-theme file association, CSP/asset scopes, Tauri capabilities, the theme-icon generator, README.md, and THEME_API_V2.md. Unused Android/iOS/Store icon assets were removed.
## What changed
**Theme API 2.0 and the editor.** The launcher now renders declarative themes with layered elements, groups, masks, filters, transforms, text and data layers, gauges, tickers, clocks, countdowns, media, Lottie, fonts, icon families, 3D cursor parallax, particle fields, logic rules, and sandboxed scripts. Custom Svelte layers are supported through an in-app Monaco editor. The standalone editor includes a live 1000×650 stage, multi-select, snapping, inspectors, previews, package import/export, backups, and trust prompts.
**The Community Workshop.** Themes can be browsed, searched, tagged, sorted, liked, downloaded, forked, reported, and installed in batches. Authenticated users can upload themes in chunks, publish new versions, and go through a pre-publication review queue. Moderators get approvals, takedowns, hidden-theme handling, and trash/restore/permanent-delete flows.
**Discord Activity presence.** Presence editing is now a full studio, opened from Settings → Integrations → Customize Activity. It has four tabs: Idle, In-Game, Buttons, and Presets. Idle covers activity text, media/badge tooltips, avatar overlays, and elapsed time. In-Game covers gameplay text, beatmap artwork, player badges, and the live match timer. Buttons has separate idle and in-game primary buttons plus a shared community/profile button; The editor includes a live Discord profile mockup that can switch between idle and gameplay, simulate beatmaps/actions, zoom in and out, and either focus fields in edit mode or test buttons in preview mode.
**A redesigned Settings menu.** Settings is now a tabbed hub with six sections: Gameplay, Appearance, Integrations, Installation, Diagnostics, and Logging. Each tab has its own description, an auto-save indicator, and a status/quick-actions sidebar. Gameplay covers patching and the Windows patcher stream; Appearance covers the Lazer-style cursor, cursor smoothing, reduced motion, and low-latency game optimization; Integrations covers Discord presence, Activity customization, and anonymous tracking; Installation covers the osu! path and Windows OpenTabletDriver; Diagnostics and Logging open the dedicated panels described below.
**Logs, diagnostics, and notifications.** Launcher, osu!, and patcher output rotates at 5 MiB and is archived into one ZIP per session, with the newest five bundles kept. The new log viewer lists bundles by date and size, switches between the three streams, filters lines, shows errors only, copies the filtered output, refreshes the list, and opens the logs folder. Diagnostics checks the launcher and platform, the osu! path/version/integrity/write access, patcher files and stream, the logs path, and platform tools: Wine prefix/runtime/.NET 8/FFmpeg on macOS, osu-winello/wmctrl on Linux, and the .NET 8 runtime on Windows. It can copy a support report and jump into Repair setup. Notifications now have full details, actions, unread counts, mark-read/mark-all, pagination, and links back to Workshop themes.
**Platform integration.** macOS gets Wineskin/Whisky/CrossOver detection, font-registry cleanup, updater-marker cleanup, patcher compatibility patching, native window rounding, and the loopback media server with FFmpeg transcoding for large theme videos. Windows gets OpenTabletDriver automation and the low-latency game optimization mode. Linux supports osu-winello and wmctrl, stays on the stable patcher stream, and remains partially supported as described in the README.
**Launcher polish and setup.** The setup wizard is now a three-step flow: welcome, osu! location, and personalization. It auto-detects installations (including macOS wrappers), explains the macOS app-bundle choice, and exposes patching, cursor, reduced-motion, and Discord options in one place. Date/time pickers, context menus, updated dialogs/tooltips/sliders, titlebar/window behavior, section icons, session-scoped editor accordion state, and installed/workshop card entry animations round out the UI work.
**Smaller but visible changes.** Theme media now handles autoplay/unmute and keeps the volume control available. The theme editor adds detachable header and player-card widgets, banner variants, custom CSS classes, and theme variables. Workshop NSFW previews stay blurred until revealed, and download progress survives tab switches. The heavy editor/Workshop/diagnostics/logs/Presence windows are lazy-loaded with explicit loading states.
**Packaging and docs.** The branch updates the NSIS/AppImage and macOS app/dmg build configs, the `.ezpplauncher-theme` file association, CSP/asset scopes, Tauri capabilities, the theme-icon generator, `README.md`, and `THEME_API_V2.md`. Unused Android/iOS/Store icon assets were removed.
Expand the theme editor with multi-select, snapping, context menus, draft
recovery and export validation; add theme backups and trust prompts. Add
in-app diagnostics and rotating log bundle viewing, hardware-accelerated
theme video playback on macOS, and refresh the settings, setup wizard and
theme gallery layouts.
- Support detaching title header to canvas with full, compact, and minimal variants
- Render detached widgets and respect chrome layout configuration in theme preview generator
- Fix macOS Wineskin launching by adding Frameworks to DYLD_FALLBACK_LIBRARY_PATH
- Fix launch button interactive handling, scaling margins, and icon-only states
- Improve player widget styling and variant display
- Remove host Apple Braille font entries from Wine prefix registry to prevent cold-start GDI+ AccessViolationException.
- Purge .require_update, help.txt, and _pending prior to osu! launch so the game launches directly with -devserver ez-pp.farm instead of entering the updater.
- Reset _UpdateFailCount in osu!.cfg and ensure execute.bat points to ez-pp.farm.
- Update ensure_patcher_compatibility to patch osu!.patcher.exe and embedded ManagedInjector.Lib for .NET 4.0 compatibility under Wine.
- Include theme editor, cursor, and download button refinements on themes-v2 branch.
Use the service owner, moderator, or supporter role for author badges, expose downloads for owned legacy themes, and move secondary card actions into a menu. Include theme tags in publish metadata and keep API 2.0 exports limited to theme.json and assets.
Add the in-app tag editor, installed-theme reporting, readable moderation and report dialogs, and notification layering fixes. Persist server-assigned workshop IDs for stable republishes, hide self-reporting, fix report-button contrast, and disable macOS autocorrect and spell checking across launcher windows.
Long announcements were clamped in the list and had nowhere to open, so
notifications now open a detail dialog with the full message, type, theme,
sender and timestamp, plus a shortcut into the Community Workshop.
Only one theme could be installed at a time because a single download id
guarded every card, so users had to repeat the flow per theme. A selection
mode now adds checkboxes and a batch bar that installs the chosen themes in
sequence, with per-theme progress and a summary of failures.
Downloads shared a single active-id guard, so a second theme could not start until the first finished, and completing one immediately applied it over the current theme. Each download now tracks its own progress, runs concurrently, and only adds the theme to the library. The batch-selection bar and checkboxes are removed in favour of the independent buttons.
New themes are submitted for review instead of appearing live, so the workshop now surfaces pending and rejected badges on the creator's own cards and adds a Review queue to the moderation panel with approve and reject actions. Publishing reports that the theme is awaiting review, and approval/rejection notifications are labelled.
The workshop is unmounted when the Installed tab is opened, so its local download state was discarded and returning to the Community tab showed no progress even though the install was still running. Active downloads and percentages now live in a shared module that outlives the component, and in-flight downloads keep updating it.
The action used window.prompt, which returns null in the Tauri webview, so the handler aborted before calling the API. Takedown and lift now use an in-app dialog with a required reason, inline errors and a loading state.
The sort, announcement audience and report category controls were still native select elements. They now use the same shadcn-svelte Select as the moderation filters for consistent styling and keyboard behavior.
Replace the remaining native prompt and confirm calls with an in-app action dialog, including focus handling and inline errors. Guard likes and concurrent moderation loads, surface stale-data errors, paginate the review queue, and keep load-more state local to each list. Allow the packaged app to reach the workshop host for API calls and previews.
Installed themes now use a 16:9 preview with stable card spacing and a single overflow menu for edit, restore, update, report and uninstall actions. Community theme previews and titles open a large detail dialog with a full-size preview, metadata, tags, review status and the relevant install action.
Installed theme cards now use the same visual hierarchy as workshop cards: status and API badges at the top, version on the preview, an author strip over the artwork, a compact title and description, and a footer with status plus compact actions. This removes the oversized primary button and duplicate version/author rows.
Installed theme cards rendered only an initial because their manifests store the author name, not an avatar URL. Use the EZPPFarm avatar endpoint with the author name and keep the initial as the image-load fallback, matching the community workshop presentation.
Publishing now stamps the signed-in EZPPFarm user ID into theme.json and saves it before packaging, so installed theme cards can resolve avatars by stable user ID. Older manifests keep the author-name fallback.
Compare the proposed version with the version currently published in the workshop before opening the publish dialog and again before upload. Reject invalid semver, duplicate versions, and downgrades, while tracking the just-submitted version in-session so pending updates cannot be published twice.
Require SemVer 2.0.0 when saving, validating, or publishing a theme, and validate again at the workshop upload boundary. This rejects partial versions, v-prefixed versions, leading-zero components, and arbitrary strings while preserving valid prerelease and build metadata.
- Lazy-load the theme editor, workshop, diagnostics, logs, and presence editor.
- Check installed themes for newer workshop versions and support updates with backup/restore.
- Preserve accordion state for the current editor session and add section icons.
- Animate installed and workshop cards on insertion, and fix the duplicate presence idle action.
Compare theme content hashes with a stored Workshop baseline so creators
can see when their local copy is not synced. Extract pointer tracking into
a shared action for the launcher and editor preview, and use the slider
component for parallax depth.
Add a confirmation dialog before removing an installed theme, warning
that local edits are deleted. Apply content padding to the absolute tab
panels so the workshop and library views stay inset from the frame.
Restore the published Workshop version after confirmation, keeping a backup of
local edits. Owner reverts send auth headers so themes-service skips the
download counter.
Make the custom cursor event-driven, pause CSS, theme video, and Lottie work
while the launcher is hidden or unfocused, and reduce presence polling while
osu is running.
Crossfade user-selected themes, keep the theme volume popover open while
dragging its slider, and clip the fixed app shell so oversized theme layers
cannot create page scrollbars on Windows. Remove the redundant in-use badge
from the active theme card.
Refresh idle activity from live mode, stats, user, and config changes, replace activity snapshots so cleared buttons and images are removed, and keep retrying Discord IPC until presence is disabled.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
What changed
Theme API 2.0 and the editor. The launcher now renders declarative themes with layered elements, groups, masks, filters, transforms, text and data layers, gauges, tickers, clocks, countdowns, media, Lottie, fonts, icon families, 3D cursor parallax, particle fields, logic rules, and sandboxed scripts. Custom Svelte layers are supported through an in-app Monaco editor. The standalone editor includes a live 1000×650 stage, multi-select, snapping, inspectors, previews, package import/export, backups, and trust prompts.
The Community Workshop. Themes can be browsed, searched, tagged, sorted, liked, downloaded, forked, reported, and installed in batches. Authenticated users can upload themes in chunks, publish new versions, and go through a pre-publication review queue. Moderators get approvals, takedowns, hidden-theme handling, and trash/restore/permanent-delete flows.
Discord Activity presence. Presence editing is now a full studio, opened from Settings → Integrations → Customize Activity. It has four tabs: Idle, In-Game, Buttons, and Presets. Idle covers activity text, media/badge tooltips, avatar overlays, and elapsed time. In-Game covers gameplay text, beatmap artwork, player badges, and the live match timer. Buttons has separate idle and in-game primary buttons plus a shared community/profile button; The editor includes a live Discord profile mockup that can switch between idle and gameplay, simulate beatmaps/actions, zoom in and out, and either focus fields in edit mode or test buttons in preview mode.
A redesigned Settings menu. Settings is now a tabbed hub with six sections: Gameplay, Appearance, Integrations, Installation, Diagnostics, and Logging. Each tab has its own description, an auto-save indicator, and a status/quick-actions sidebar. Gameplay covers patching and the Windows patcher stream; Appearance covers the Lazer-style cursor, cursor smoothing, reduced motion, and low-latency game optimization; Integrations covers Discord presence, Activity customization, and anonymous tracking; Installation covers the osu! path and Windows OpenTabletDriver; Diagnostics and Logging open the dedicated panels described below.
Logs, diagnostics, and notifications. Launcher, osu!, and patcher output rotates at 5 MiB and is archived into one ZIP per session, with the newest five bundles kept. The new log viewer lists bundles by date and size, switches between the three streams, filters lines, shows errors only, copies the filtered output, refreshes the list, and opens the logs folder. Diagnostics checks the launcher and platform, the osu! path/version/integrity/write access, patcher files and stream, the logs path, and platform tools: Wine prefix/runtime/.NET 8/FFmpeg on macOS, osu-winello/wmctrl on Linux, and the .NET 8 runtime on Windows. It can copy a support report and jump into Repair setup. Notifications now have full details, actions, unread counts, mark-read/mark-all, pagination, and links back to Workshop themes.
Platform integration. macOS gets Wineskin/Whisky/CrossOver detection, font-registry cleanup, updater-marker cleanup, patcher compatibility patching, native window rounding, and the loopback media server with FFmpeg transcoding for large theme videos. Windows gets OpenTabletDriver automation and the low-latency game optimization mode. Linux supports osu-winello and wmctrl, stays on the stable patcher stream, and remains partially supported as described in the README.
Launcher polish and setup. The setup wizard is now a three-step flow: welcome, osu! location, and personalization. It auto-detects installations (including macOS wrappers), explains the macOS app-bundle choice, and exposes patching, cursor, reduced-motion, and Discord options in one place. Date/time pickers, context menus, updated dialogs/tooltips/sliders, titlebar/window behavior, section icons, session-scoped editor accordion state, and installed/workshop card entry animations round out the UI work.
Smaller but visible changes. Theme media now handles autoplay/unmute and keeps the volume control available. The theme editor adds detachable header and player-card widgets, banner variants, custom CSS classes, and theme variables. Workshop NSFW previews stay blurred until revealed, and download progress survives tab switches. The heavy editor/Workshop/diagnostics/logs/Presence windows are lazy-loaded with explicit loading states.
Packaging and docs. The branch updates the NSIS/AppImage and macOS app/dmg build configs, the
.ezpplauncher-themefile association, CSP/asset scopes, Tauri capabilities, the theme-icon generator,README.md, andTHEME_API_V2.md. Unused Android/iOS/Store icon assets were removed.View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.