{"id":19903729,"url":"https://github.com/regolith-linux/ilia","last_synced_at":"2025-04-06T19:11:32.029Z","repository":{"id":37049695,"uuid":"410751665","full_name":"regolith-linux/ilia","owner":"regolith-linux","description":"A GTK-based Desktop Executor","archived":false,"fork":false,"pushed_at":"2024-10-24T12:30:09.000Z","size":388,"stargazers_count":79,"open_issues_count":35,"forks_count":10,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-29T18:48:25.578Z","etag":null,"topics":["desktop-environment","gtk3","i3wm","rofi","swaywm","vala"],"latest_commit_sha":null,"homepage":"","language":"Vala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/regolith-linux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-27T05:22:24.000Z","updated_at":"2024-10-26T03:19:55.000Z","dependencies_parsed_at":"2023-12-19T04:22:56.964Z","dependency_job_id":"f25d7769-3a6a-4fba-bb3e-bab02dca1fda","html_url":"https://github.com/regolith-linux/ilia","commit_stats":{"total_commits":245,"total_committers":7,"mean_commits":35.0,"dds":"0.31836734693877555","last_synced_commit":"18c84778a2f1c3fc915156a845c25a9ee07dbeb7"},"previous_names":[],"tags_count":119,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Filia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Filia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Filia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regolith-linux%2Filia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/regolith-linux","download_url":"https://codeload.github.com/regolith-linux/ilia/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244536636,"owners_count":20468387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["desktop-environment","gtk3","i3wm","rofi","swaywm","vala"],"created_at":"2024-11-12T20:25:05.936Z","updated_at":"2025-03-23T17:09:09.494Z","avatar_url":"https://github.com/regolith-linux.png","language":"Vala","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ilia - A Desktop Executor\n\nIlia is a tool for users to invoke actions such as launching apps, viewing notifications, and finding windows.  It provides a modal interface consisting of a filter box, and a list of matching items. There are a set pages that can be selected from by specifying the desired page via a command-line parameter or by tab if all pages are loaded (controlled by command-line parameter).\n\n![Ilia Screenshot](https://regolith-desktop.com/regolith-ilia-keybinding-window.png)\n\n## Features\n\nIlia provides pages to view and select from the following types of things:\n* Desktop Apps (`apps`)\n* System Commands (`terminal`)\n* Desktop Keybindings (`keybindings`)\n* Notifications (`notifications`)\n* Text List (`textlist`)\n* File Search (`tracker`)\n* Open Windows (`windows`)\n\n## Usage\n\nIlia can be launched from a terminal. The `-p` option allows to specify which page to present to the user.\n\nEx:\n```\nilia -p keybindings\n```\n\n### Desktop Apps\n\nIlia searches the system-configured `$XDG_DATA_DIRS` with `applications` applied at the end of each path for desktop application files.  For example, if your system has `$HOME/.local/share` in the set of paths in `$XDG_DATA_DIRS`, the path `$HOME/.local/share/applications/` will be searched for destkopt app files.\n\n### Text List\n\nThe `textlist` page is a bit different than the others pages.  It provides a general purpose utility to provide a list of options for the user select and when the selection occurs, the selected item is returned by the invocation to `ilia`.  In this way the program can be used in scripts to get user input from dynamic data, similar to `rofi`.  The `textlist` page supports two additional parameters for more customization:\n\n```\n'textlist' - select an item from a specified list\n        -l: page label\n        -i: page icon\n```\n\n## Configuration\n\nIlia supports the following configuration via gsettings under the namespace `org.regolith-linux.ilia`:\n\n* window-width: width of window in pixels\n* window-height: height of window in pixels\n* icon-size: size of icons in pixels or 0 to disable icons\n\n### Example: Resetting screen width\n\n```\ngsettings reset org.regolith-linux.ilia window-width\n```\n\n## Dependencies\n\n### Notifications\n\nThis page communicates with the [Rofication](https://github.com/regolith-linux/regolith-rofication) daemon for managing desktop notifications.\n\n### Keybindings\n\nThis page uses the comment format specified by [Remontoire](https://github.com/regolith-linux/remontoire) and reads the i3 config via it's local socket.\n\n## Build\n\nIlia uses `meson` and `ninja` to build.  Example:\n\n```shell\ngit clone https://github.com/regolith-linux/ilia.git\nmkdir ilia/build\ncd ilia/build\nmeson ..\nninja\nsrc/ilia\n```\n\n## Lint\n\n### Uncrustify\n\n```shell\nninja fixstyle\n```\n\n## Package\n\nDebian packages for Debian and Ubuntu are available in the [Regolith package repository](https://github.com/regolith-linux/voulage).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fregolith-linux%2Filia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fregolith-linux%2Filia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fregolith-linux%2Filia/lists"}