Skip to main content
Manual Installation on Linux / Chrome OS

If you don't / can't use the AppImageLauncher, here's how to install manually

Updated over 3 months ago

To install Linux AppImages in Chrome OS and enable deeplinks (custom URL schemes) like supernotes://open, follow these steps. Deeplinks are required for authentication, you might be able to run the app, but you won't be able to login without them.

Step 1: Enable Linux (Beta) on Chrome OS

1. Open Settings on your Chromebook.

2. Navigate to "Linux (Beta)" and click "Turn On".

3. Follow the on-screen instructions to set up Linux (Beta).

Step 2: Download and Make the AppImage Executable

1. Download the AppImage for Supernotes from the official website.

2. Open the Terminal in Chrome OS.

3. Navigate to the directory where the AppImage is downloaded:

cd ~/Downloads

4. Make the AppImage executable:

chmod +x Supernotes.AppImage

Step 3: Create a Desktop Entry for the AppImage

1. Create a .desktop file for the AppImage:

nano ~/.local/share/applications/supernotes.desktop

2. Add the following content to the .desktop file:

[Desktop Entry]
Name=Supernotes
Exec=/home/your-username/Downloads/Supernotes.AppImage
Icon=/home/your-username/Downloads/supernotes-icon.png
Type=Application
Categories=Utility;
MimeType=x-scheme-handler/supernotes;

Replace /home/your-username/Downloads/Supernotes.AppImage with the actual path to your AppImage and update the icon path if necessary.

3. Save and close the file by pressing CTRL + X, then Y, and Enter.

Step 4: Register the Custom URL Scheme

1. Update the MIME types database:

xdg-mime default supernotes.desktop x-scheme-handler/supernotes

Step 5: Verify the Deeplink

1. Open Chrome and type supernotes://open in the address bar.

2. It should prompt you to open the Supernotes AppImage.

Additional Notes

• Ensure that the path to the AppImage and icon are correct in the .desktop file.

• You may need to install other dependencies or libraries required by the AppImage.

• If the deeplink does not work immediately, try restarting your Chromebook or the Linux container.

This setup allows you to run AppImages on Chrome OS and use custom URL schemes to open these applications directly from the browser.

Did this answer your question?