Getting Started
Get started with mosium
mosium is designed around remembering where an item is placed, not only what it is called. Intentional empty space is part of the layout.
1. Add items
Use Add in the Toolbar to register apps, files, folders, URLs, and Shortcuts.
You can also drag apps, files, and folders from Finder into the Grid, and drag supported web URLs from a browser.
If you select an empty cell first, the item is added there. Otherwise mosium uses an available empty position.
2. Arrange the Grid
Drag a registered item to an empty cell to move it.
Drag onto another item to swap their positions.
Empty cells are preserved. Removing or moving an item does not automatically pack the remaining items toward the top-left.
3. Open an item
- Click an item: open it
- Arrow keys: move the selection
- Enter / Return: open the selected item
In Normal mode, the launcher closes after an item opens successfully.
4. Choose how item names appear
In Settings > General > Item Name Display, choose:
- Always Visible
- Active Only
- Always Hidden
With Active Only, a name appears while the item is hovered or selected.
5. Search
With the launcher focused, start typing to search.
Search keeps the Grid's spatial relationship intact while helping you find matching items.
Press Escape to clear the active search state.
6. Quick Look / Finder
Select a local file and press Space to preview it with macOS Quick Look.
Use Reveal in Finder from the Action or context menu to locate a local item.
Opening a folder item normally opens it in Finder.
7. Collections
Each Collection can have its own layout and Grid size.
Free has one usable Collection. Full lets you create and switch between multiple Collections from the Sidebar.
8. Invocation Profiles
Open Settings > Invocation Profiles to configure how mosium is brought forward.
A custom profile can define:
- Name
- Global Shortcut
- Target Collection
- Initial Placement
- Window Mode
Placement can use Monitor Center, Cursor / Window Center, Cursor / Top-left Grid, or a Placement Preset.
Free includes one custom profile in addition to the Standard Profile. Full removes the edition limit on custom profiles.
9. Placement Presets
Save a launcher-window position and use it from an Invocation Profile.
If the display setup changes, mosium uses its safe placement/recovery behavior to keep the launcher on an available screen.
10. Backup / Restore
Use File > Export Backup… to export your Collections and settings.
File > Import Backup… validates the selected backup and asks before replacing the current state. mosium keeps a safety backup of the pre-import state.
Backups may contain references to local files. Items can require relinking after restoring on another Mac.
11. Relink
If a registered file or folder moves, or its saved access can no longer be used, mosium does not automatically delete the launcher item.
Use Relink… to point it to the current location.
12. Free / Full
Free
- 1 Collection
- Grid up to 6 × 8
- 1 custom Invocation Profile
- 1 Placement Preset
Full
- Removes those edition limits
- One-time purchase
Purchase and restore controls are available in Settings > General.