Companella!

Rate changer (single and bulk)

Create practice-friendly copies of beatmaps at different playback speeds. The client exposes this through RateChangerPanel (gameplay) and BulkRateChangerPanel (mapping), including mod-style selection via ModSelectionPanel.

Single-rate mode

• Set a rate multiplier (for example 0.9x, 1.1x, 1.5x) for the current map context.
• Customize difficulty naming with variables such as {rate}, {bpm}, and {original}.
• Generates the rate-adjusted .osu and processed audio for that map.

Bulk rate mode

• Generate many rate versions in one pass: minimum, maximum, and step (for example 0.8x to 1.3x in 0.05 steps).
• Quick presets for common ranges and a preview of which rates will be produced before applying.

Marathon creator

MarathonCreatorPanel stitches multiple beatmaps into one marathon. You manage entries, pauses, order, per-map rates, and optional storyboard and audio transitions.

Map list and structure

• Add maps from your current selection, insert pause or break sections with custom duration, and reorder segments (drag or move controls).
• Set an individual playback rate per included map when needed.
• View MSD (MinaCalc) difficulty hints per entry to compare segments.

Background and visuals

• Build a composite background from all included maps (radial "shard" layout).
• Optional center symbol using Greek letters or special symbols; adjustable glitch-style effects (for example RGB shift, scanlines, wave distortion, block glitches).
• Live preview that updates as you change maps, effects, or the center symbol.

Audio and timing

• Storyboard-friendly highlight transitions between maps where configured.
• Crossfading between map audio for smoother joins.
• SV (scroll velocity) normalization when BPM sections differ, plus a generated structure document describing the full marathon.

Sessions, replay analysis, and skills

Under Gameplay, SessionPanel tracks practice; SkillsAnalysisPanel charts trends. Replay and beatmap analysis requests are wired from the session UI for deeper timing and pattern insight.

Session tracker

• Detects completed plays and records accuracy, MSD-related difficulty, and timing information for the active session.
• Start and stop controls with session duration; charts for MSD and accuracy over the session.
• Session history to compare days and spot productive practice windows.

Skills analysis

• Time windows such as 24 hours, 7 / 30 / 90 days, or all time.
• Skillsets include overall, stream, jumpstream, handstream, stamina, jackspeed, chordjack, technical, and related views with trend indicators.

Patterns and dan practice

• Pattern-oriented breakdown (streams, jacks, chordjacks, trills, brackets, and more) with BPM context.
• Dan-oriented training across numeric dans 1–10 and Greek-letter sets (alpha through kappa), with MSD-oriented targets for practice.

Session planner and smart recommendations

SessionPlannerPanel builds structured sessions; the recommendation flow loads maps from your library based on skills data and focus modes.

Recommendations

• Push — slightly above comfort to improve.
• Consistency — maps near your current level for stable accuracy.
• Deficit fixing — targets weaker skillsets.
• Skillset focus — emphasizes stream, jumpstream, handstream, stamina, jack, chordjack, technical, and similar.
• Shows MSD and dominant skillset; one-click to load in osu! where supported; quick restart of the last recommendation.

Session planner

• Modes such as generating from analysis or manual targets (skillset and difficulty).
• Phases: warmup, ramp-up, main practice, and cooldown with map picks and estimated duration.
• Can create osu! collections for the planned session maps.

Map database, indexing, and scores

Settings integrates MapIndexingPanel, MinaCalc version selection, score migration and import paths, and analytics preferences so recommendations and MSD features stay in sync with your library.

Indexing

• Quick index — pick up new maps only.
• Full reindex — rebuild calculated data across the library.
• Refresh — update for recent file or metadata changes.

Stored data (typical)

• MSD values for 4K mania maps, pattern-oriented signals, and map metadata (title, artist, creator, difficulty name) with paths for quick access.
• Integration with session and recommendation features once indexing has run.

Scores and migration

• Utilities for migrating scores from session copies and importing from osu! scores.db into session-oriented workflows where configured.

Mapping tab utilities

The Mapping tab groups creator-oriented tools: FunctionButtonPanel, OffsetInputPanel, bulk rate generation, and the marathon workflow described above.

Common mapper workflows

• BPM analysis — analyze audio to infer BPM and help build or verify timing points.
• SV normalization — align scroll velocity across BPM changes while preserving intentional effects where possible.
• Global offset — shift all timing points by a chosen offset for sync fixes.
• Bulk rate and marathon — same engines as in gameplay, oriented toward batch production and long maps.

Overlay mode, settings, and updates

Overlay

• Attach to the osu! window so Companella stays visible during play; hides when focus leaves osu! depending on configuration.
• Toggle visibility with a configurable hotkey (default Alt+Q in documentation).
• Position options (for example left, right, or detached) with remembered layout.

Settings highlights

• UI scale for different displays and DPI.
• Keybind configuration for overlay and related shortcuts.
• Optional anonymous usage analytics to help improve the app.
• Session auto-start and related session behavior.
• Quick Setup and tutorial overlays for first-time orientation.

Updates

• Automatic update checks with in-app install flows (see the download page for major migration notes when installers change).