{"id":27521144,"url":"https://github.com/amaterasu-uwu-xd/termlaunch","last_synced_at":"2025-04-18T07:58:54.893Z","repository":{"id":287434674,"uuid":"964723260","full_name":"amaterasu-uwu-xd/termlaunch","owner":"amaterasu-uwu-xd","description":"[WIP] Launch your desktop applications through a terminal emulator","archived":false,"fork":false,"pushed_at":"2025-04-15T20:53:31.000Z","size":3754,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-15T21:22:24.519Z","etag":null,"topics":["launcher-application","linux","tui"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amaterasu-uwu-xd.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,"zenodo":null}},"created_at":"2025-04-11T17:18:20.000Z","updated_at":"2025-04-15T20:54:37.000Z","dependencies_parsed_at":"2025-04-16T10:20:18.740Z","dependency_job_id":null,"html_url":"https://github.com/amaterasu-uwu-xd/termlaunch","commit_stats":null,"previous_names":["amaterasu-uwu-xd/termrun","amaterasu-uwu-xd/termlaunch"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaterasu-uwu-xd%2Ftermlaunch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaterasu-uwu-xd%2Ftermlaunch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaterasu-uwu-xd%2Ftermlaunch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaterasu-uwu-xd%2Ftermlaunch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amaterasu-uwu-xd","download_url":"https://codeload.github.com/amaterasu-uwu-xd/termlaunch/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249458812,"owners_count":21275770,"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":["launcher-application","linux","tui"],"created_at":"2025-04-18T07:58:54.475Z","updated_at":"2025-04-18T07:58:54.878Z","avatar_url":"https://github.com/amaterasu-uwu-xd.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Termlaunch\n\nThis is a very WIP project that allows you to launch your desktop applications through a terminal emulator. It is designed with the worst developer practices.\n\nhttps://github.com/user-attachments/assets/8fbf3679-7065-43a9-8809-ce434fd53846\n\n## Features\n- Launch applications or some of its actions\n- Search\n- Icon preview support\n- Customizable (WIP)\n  \n## Limitations\n- Some desktop entries could break the application\n- If you have not configured a terminal emulator, it will use `kitty` as default\n\n## Installation\n\n### Using precompiled binaries\n\nFrom the [releases section](https://github.com/amaterasu-uwu-xd/termlaunch/releases), you can download the latest release available.\n\nDownload the binary for your architecture and place it in your `$PATH`. Make sure to give it execute permissions:\n\n```bash\nchmod +x /path/to/termlaunch\n```\n\n### Using cargo\nYou can install it using cargo, the Rust package manager. You can install it with the following command:\n\n```bash\ncargo install termlaunch\n```\n\nOr you can follow the latest commit in the repository:\n\n```bash\ncargo install --git https://github.com/amaterasu-uwu-xd/termlaunch\n```\n\nMake sure you have `$HOME/.cargo/bin` in your `$PATH`. \n\n\n## Building from source\nIf you want to build it from source, you can clone the repository and build it using cargo. Make sure you have Rust and Cargo installed. You can install them using [rustup](https://rustup.rs/). Requires `1.85.0` or higher.\n```bash\ncd ~/Downloads\ngit clone https://github.com/amaterasu-uwu-xd/termlaunch\ncd termlaunch\n# Make sure you have Rust and Cargo installed, if not, you can install it using rustup\ncargo build --release\n```\n\nThis will create a binary in `target/release/`. You can copy it to your `$PATH` or run it directly from the build folder.\n\n## Integration with WM\nThe integration is very simple, you just need to add a keybinding to your window manager. Optionally, you can add some window rules.\n\nThis is an example for Hyprland:\n\n```hyprlang\n# This bind uses $terminal as the terminal emulator, if you want to use another, you can replace it with your preferred terminal.\nbind = $mainMod, R, exec $terminal --class termrun -e /path/to/termrun\n\n# Window rules\nwindowrule = float, class:(termrun)\nwindowrule = size 100x600, class:(termrun)\nwindowrule = stayfocused, class:(termrun)\n```\n\n## Configuration\nThe configuration file is located in `$XDG_CONFIG_HOME/termlaunch/config.toml` or `$HOME/.config/termlaunch/config.toml`. You can also use the `--config` flag to specify a different configuration file.\n\n### Example configuration\n```toml\n# Actually only the terminal emulator and the icon theme are supported\nterminal = \"kitty\"\nicon_theme = \"Papirus\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famaterasu-uwu-xd%2Ftermlaunch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famaterasu-uwu-xd%2Ftermlaunch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famaterasu-uwu-xd%2Ftermlaunch/lists"}