🎉 Initial Release — Clip Studio Scheme Handler (Linux)
This release provides a native Linux x-scheme handler for clipstudio:// URLs, allowing Clip Studio Assets downloads to work seamlessly when running Clip Studio through Bottles.
If you’ve ever clicked a material download link on Linux and… nothing happened — this fixes that.
✨ What this does
- Registers a system handler for clipstudio:// links
- Forwards asset download URLs into your Bottles Clip Studio environment
- Automatically launches Clip Studio if it isn’t already running
- Prevents duplicate download triggers
- Works with Flatpak Bottles setups
Once installed, clicking a Clip Studio Asset download link should behave just like Windows.
📦 Package contents
The .deb installs:
/usr/bin/clipstudio-handler
/usr/bin/clipstudio-worker
/usr/share/applications/clipstudio-handler.desktop
It also registers:
x-scheme-handler/clipstudio
✅ Requirements
Before installing, make sure you have:
- Flatpak
- Bottles (Flatpak: com.usebottles.bottles)
- A bottle named Clip Studio
- A Bottles program entry named CLIPStudio
🚀 Installation
Download the .deb from this release, then:
sudo dpkg -i clipstudio-scheme-handler_*_all.deb
sudo update-desktop-database /usr/share/applications
Verify registration:
gio mime x-scheme-handler/clipstudioTest:
gio open "clipstudio://test"🧪 Known limitations
- Designed for Bottles Flatpak environments
- Assumes default Clip Studio install path inside the bottle
- Not tested with Wine outside Bottles (yet)
🐛 Troubleshooting
Logs are written to:
~/.cache/clipstudio/
Key files:
handler.log
worker.script.log
❤️ Feedback welcome
This is the first public release. Issues, edge cases, and weird setups are very welcome — please open an issue if something doesn’t behave as expected.