Run a downloaded app on namiOS
VS Code’s, Discord’s and JetBrains’ own downloads, AppImages, games, and programs from GitHub releases, npm or pip are made for an ordinary distribution. On namiOS they run as they are.
tar xf zed-linux-x86_64.tar.gz
./zed.app/bin/zed
Double-clicking one in Files works too. On Ubuntu, Fedora and other distributions, these programs already find the libraries they expect, so there’s nothing to do.
Add a library a program is missing
When a program needs a library namiOS doesn’t give it, it says which one, and which package has it.
./game
namiOS: game is built for another distribution, and needs a library this computer doesn't have:
libfoo.so.1, which the package foo has
Add it for your programs: nami libraries --add ./game
Run the command it suggests:
nami libraries --add ./game
packages: - firefox - fooStarted from Files or the launcher, the same shows as a notification with an Add button.
Add a library for everyone
To give a library to every program on the computer, list it under libraries: in a package of your own, and list that package in computer.nami.
libraries: [foo]namiOS starts these programs with nix-ld, which gives them glibc and a set of common libraries, from GTK and OpenGL to OpenSSL and SDL. Only those programs see the set.
Put an AppImage in the launcher
An AppImage runs as it is. After its first start, namiOS offers to add it to the launcher with its own name and icon.
nami add-to-launcher ~/Downloads/Obsidian-1.7.7.AppImage
[Desktop Entry]Type=ApplicationName=ObsidianComment=ObsidianCategories=Office;Exec=/nix/var/nami/bin/nami start /home/ada/Downloads/Obsidian-1.7.7.AppImage %UIcon=/home/ada/.local/share/nami/icons/nami-obsidian.pngPath=/home/ada/DownloadsOpen With > Add to Launcher in Files does the same, for any downloaded program.
Install an app that’s only a .deb
Some apps are only in Ubuntu’s archive or on their maker’s site as a .deb. nami recipe from-deb turns one into a package you can install on any distribution.
nami recipe from-deb dctrl-tools
nami build ./dctrl-tools
nami install ./dctrl-tools
packages: - firefox - ./dctrl-toolsYour own packages explains what it writes and how to fix what it couldn’t match.
Know what doesn’t work
- pip’s wheels in the system’s
python3. Use a Python made for other distributions, such as uv’s (uv venv --managed-python), pyenv’s or conda’s. - 32-bit programs. Steam and Proton bring their own runtime, so they work.
- Programs that look for their own files under
/usr. Make a recipe from the download instead. - A program that brings its own copy of a library can get the set’s copy first. If it breaks, start it with
LD_LIBRARY_PATH=./lib ./program.
A program that’s already executable starts from Files without a word if it lacks a library, so run it in a terminal to see why.