{"id":22310874,"url":"https://github.com/joaoiacillo/steam-dmenu","last_synced_at":"2026-05-02T09:33:40.661Z","repository":{"id":219340909,"uuid":"748796281","full_name":"joaoiacillo/steam-dmenu","owner":"joaoiacillo","description":"A dmenu wrapper for launching Steam applications more easily.","archived":false,"fork":false,"pushed_at":"2024-01-26T22:30:18.000Z","size":14,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T23:30:35.811Z","etag":null,"topics":["dmenu","dmenu-wrapper","linux","steam"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joaoiacillo.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":"2024-01-26T19:31:01.000Z","updated_at":"2024-01-26T19:39:09.000Z","dependencies_parsed_at":"2025-01-30T23:29:21.172Z","dependency_job_id":"ac26d9a5-b1d4-4ac9-af55-10fa62555925","html_url":"https://github.com/joaoiacillo/steam-dmenu","commit_stats":null,"previous_names":["joaoiacillo/steam-dmenu"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaoiacillo%2Fsteam-dmenu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaoiacillo%2Fsteam-dmenu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaoiacillo%2Fsteam-dmenu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaoiacillo%2Fsteam-dmenu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joaoiacillo","download_url":"https://codeload.github.com/joaoiacillo/steam-dmenu/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245573893,"owners_count":20637674,"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":["dmenu","dmenu-wrapper","linux","steam"],"created_at":"2024-12-03T21:16:32.502Z","updated_at":"2026-05-02T09:33:40.618Z","avatar_url":"https://github.com/joaoiacillo.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# steam-dmenu\n\nA dmenu wrapper for launching Steam applications more easily.\n\n## Motivation\n\nLaunching Steam just to run a single game can be quite an adventure, specially if you are on a slow computer.\n\nThat's why this project aims at providing a simple implementation of a launcher for Steam applications through the `dmenu`\ninterface.\n\nSteam will silently run on the background, and only your game screen will pop out after Steam's load time.\n\n## Install\n\nSince steam-dmenu is just a Bash script, you can either move, copy or link it directly into a\nfolder located in the `$PATH` env variable (such as `/usr/bin/`).\n\nThe `dmenu_run` Bash script that comes shipped in the official dmenu package inserts\nitself into `/usr/bin/`. That's why we recommend **moving** steam-dmenu\ninto it as well.\n\n```bash\n$ git clone https://github.com/joaoiacillo/steam-dmenu\n$ chmod +x steam-dmenu/steam-dmenu\n$ sudo mv steam-dmenu/steam-dmenu /usr/bin\n$ rm -fr steam-dmenu/\n```\n\n## Usage\n\nYou can run `steam-dmenu` directly from the terminal or dmenu, as well as bind a\nkeymap in your desktop environment. Every argument that comes after the script\nname will be directed to dmenu, so customization is possible.\n\n```bash\n# Runs steam-dmenu on a separate thread\n$ steam-dmenu \u0026\n```\n\n### Integrating with i3wm\n\nYou can configure your i3wm to run steam-dmenu after some key combination was\npressed. The default we recommend is `$mod+Shift+s`, which stands for \"(S)tart\n(S)team [App]\".\n\nAppend the following lines to `~/.config/i3/config` file:\n\n```bash\n# Launch steam-dmenu\nbindsym $mod+Shift+s exec --no-startup-id steam-dmenu\n```\n\n### Case-insensitive search\n\nFor compatibility reasons, the default mode for searching in steam-dmenu is the\nsame as dmenu: case-sensitive. This means that `Terraria` differs from\n`terraria` and `tERRaRIA`. That's why we recommend toggling the `-i`\n(case-insensitive) option.\n\n```bash\n# Runs steam-dmenu in case-insensitive mode\n$ steam-dmenu -i \u0026\n```\n\n## Configuration\n\nYou can configure steam-dmenu through environment variables. Below is a table of\nthe variables you can modify.\n\n| Name      | Type     | Description                                           |\n| --------- | -------- | ----------------------------------------------------- |\n| STEAMROOT | `String` | Steam's root folder. Used to get steamapps directory. |\n\n## Customization\n\nThis project is literally just a wrapper to dmenu. That's why it is possible to\ncustomize the way it displays. You can use all dmenu customization options.\n\n\u003e Run `man dmenu` for listing all customization options. Use the letter `q` to\n\u003e exit the manual.\n\nBelow are some common customization options:\n\n### Setting Fira Code as default font\n\n```bash\n$ steam-dmenu -fn \"Fira Code\"\n```\n\n### Showing the panel at the bottom\n\n```bash\n$ steam-dmenu -b\n```\n\n### Modifying the default prompt\n\n```bash\n$ steam-dmenu -p \"[steam]:\"\n```\n\n## Contributions\n\nWe welcome and appreciate contributions to this project. Feel free to use,\nredistribute, and edit the source code under the following guidelines:\n\n1. **Freedom to Use:** You can use the software for any purpose without any restrictions.\n\n2. **Freedom to Modify:** You have the right to modify the source code to suit your needs.\n\n3. **Freedom to Share:** You can distribute your modified or unmodified version of the software.\n\n4. **Open Source:** Any projects derived from this codebase must be free and open-source.\n\n5. **Proper Credits:** When using or redistributing the code, ensure that proper credits are provided to the original authors. This helps acknowledge the contributors and promotes a collaborative community.\n\nIf you make enhancements, bug fixes, or other modifications, we encourage you to contribute them back to this project by creating a pull request. By doing so, you help improve the software for everyone.\n\nFor major contributions, please reach out to us beforehand to discuss the changes and ensure alignment with the project's goals.\n\nThank you for considering contributing to our project!\n\n## License\n\nThis project is licensed under the GNU GPL v3 license - see the\n[LICENSE](./LICENSE) file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaoiacillo%2Fsteam-dmenu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoaoiacillo%2Fsteam-dmenu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaoiacillo%2Fsteam-dmenu/lists"}