Help: I can't open any files

These features are provided by XDG desktop portals, specifically:

  • org.freedesktop.portal.FileChooser
  • org.freedesktop.portal.OpenURI

Some window managers, such as Hyprland, don't provide a file picker by default. See this list as a starting point for alternatives.

Linux: Could not start inotify

Gram relies on inotify to watch your filesystem for changes. If you cannot start inotify then Gram will not work reliably.

If you are seeing "too many open files" then first try sysctl fs.inotify.

  • You should see that max_user_instances is 128 or higher (you can change the limit with sudo sysctl fs.inotify.max_user_instances=1024). Gram needs only 1 inotify instance.
  • You should see that max_user_watches is 8000 or higher (you can change the limit with sudo sysctl fs.inotify.max_user_watches=64000). Gram needs one watch per directory in all your open projects + one per git repository + a handful more for settings, themes, keymaps, extensions.

It is also possible that you are running out of file descriptors. You can check the limits with ulimit and update them by editing /etc/security/limits.conf.

If you build and run from source and haven't already installed Gram as an application, the gram:// links will not work properly. To get them working, you will need to either build an application bundle yourself or install one of the pre-built bundles from the Gram website.