Desktop App
ShioriCode runs as a native desktop app. Available for active paid Shiori subscribers on macOS (Apple Silicon and Intel), Linux, and Windows.
Access
ShioriCode desktop access currently requires an active paid Shiori subscription. Free Shiori accounts do not include the app.
Platforms
| Platform | Architecture | Format |
|---|---|---|
| macOS | Apple Silicon (arm64), Intel (x64) | DMG |
| Linux | x64 | AppImage |
| Windows | x64 | Installer |
Features
- Update checks - The app checks for updates automatically and lets you download them from the UI
- Companion CLI - Install the
shioricommand directly from the app settings - Custom desktop scheme - Uses the
shioricode://app scheme internally for the packaged desktop shell - System font detection - Uses your system fonts for a native look
- OS theme integration - Follows your system light/dark mode preference
- Native window controls - macOS traffic light buttons and platform-appropriate chrome
Auto-Updates
The desktop app checks for new versions automatically.
When an update is available, you'll see a notification in the app and can choose when to download it. Once downloaded, the update is applied on restart.
Building from Source
To build the desktop app locally:
macOS DMG
bun run dist:desktop:dmg
Linux AppImage
bun run dist:desktop:linux
Windows Installer
bun run dist:desktop:win
Unsigned builds work without code signing secrets. The CI pipeline automatically signs releases when Apple or Azure credentials are configured.
Development Mode
bun run dev:desktop
This starts the desktop app in development mode with hot-reload for the web UI.
Companion CLI
The desktop app can install the shiori command for you, or you can install the shiori-cli package manually. See the CLI Reference for available commands.
Related
- Getting Started - First-time setup and your first session
- Keybindings - Customize keyboard shortcuts