{"id":26446548,"url":"https://github.com/wervice/salut","last_synced_at":"2025-03-18T12:18:20.969Z","repository":{"id":281882915,"uuid":"946740565","full_name":"Wervice/salut","owner":"Wervice","description":"Salut is a beautiful terminal greeter","archived":false,"fork":false,"pushed_at":"2025-03-11T16:25:06.000Z","size":94,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-11T17:26:58.546Z","etag":null,"topics":["cpp","shell","terminal","theming"],"latest_commit_sha":null,"homepage":"","language":"C++","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/Wervice.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":"2025-03-11T15:50:33.000Z","updated_at":"2025-03-11T17:08:35.000Z","dependencies_parsed_at":"2025-03-11T17:27:03.595Z","dependency_job_id":"46f5b8a4-027e-4842-8156-22b05831741e","html_url":"https://github.com/Wervice/salut","commit_stats":null,"previous_names":["wervice/salut"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wervice%2Fsalut","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wervice%2Fsalut/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wervice%2Fsalut/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wervice%2Fsalut/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wervice","download_url":"https://codeload.github.com/Wervice/salut/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244217953,"owners_count":20417677,"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":["cpp","shell","terminal","theming"],"created_at":"2025-03-18T12:18:20.250Z","updated_at":"2025-03-18T12:18:20.964Z","avatar_url":"https://github.com/Wervice.png","language":"C++","readme":"# Salut\n## A beautiful terminal greeter 🌸\n\nSalut is a simple yet beautiful terminal greeter.   \nTo use it, simply attach the path of the salut binary to the top of your shell config file.\nSalut will then launch, everytime you open your shell.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"screenshot.png\" width=\"500\" alt=\"Salut in action\" /\u003e\n\u003c/div\u003e\n\n### Installation\nSalut does not come pre-built for any distributions.   \nYou have to build it your self.\n\n1. Clone this repository\n`git clone https://github.com/Wervice/salut`\n2. Compile and run the source code   \na) Using GCC\n`g++ -o salut main.cpp -lfmt \u0026\u0026 ./salut`\nb) Using Clang\n`clang++ -o salut main.cpp -lfmt \u0026\u0026 ./salut`\nc) If you are on NixOS\n`nix-shell`\n\n3. Copy the executable somewhere else\nI recommend moving the executable into a folder in your `$PATH`, but you can choose any location you like.\n4. Add `salut` binary path to your config file\nDepending on your shell, your config file may be called:\n- `.zshrc`\n- `.bashrc`\n5. Salut will now launch every time you open a new shell\n\n### Usage\nTo keep salut open, you need to press `:` one time, before you can do anything.\nIf you do not press `:`, the splash screen will instantly close at the first key press and leave your default shell.\nSalut uses a command line at the bottom of your terminal for inputs. You do not need to enter the `:` when writing commands.\nYou run the programs in the list by entering their corresponding command.\nBy default the following commands are implemented:\n|Command|Action|\n|-------|------|\n|`q`    |Exits salut|\n|`h`    |Shows help|\n|`main` |Returns to main screen|\n|`nv`   |Opens neovim|\n|`ft `  |Opens fastfetch|\n|`bs`   |Starts bash|\n|`bp`   |Opens btop|\n\n### Configuration\nSalut does not feature a config file. Thus, you have to edit the source code to modify `salut`.\nTo set your own applications, edit the `options` variable in `int main`.\nYou can change the `prefix` char using the prefix variable.\n\n```cpp\nvector\u003ctuple\u003cstring, string, string, string\u003e\u003e options = {\n      make_tuple(\"Neovim\", \" \", \"nv\", \"nvim\"),\n      make_tuple(\"Fastfetch\", \" \", \"ft\", \"fastfetch\"),\n      make_tuple(\"Bash\", \" \", \"bs\", \"bash\"),\n      make_tuple(\"Btop\", \" \", \"bp\", \"btop\"),\n  };\n```\nJust copy-'n-paste a line and edit it to create a new link.\n\nPlease note, that `salut` will not display links or ascii art if the terminal is to small.\n\n### The name\nThe name of `salut` comes from the french \"salut\", which means \"Hi\".\nIt is pronouced without the t in the end.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwervice%2Fsalut","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwervice%2Fsalut","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwervice%2Fsalut/lists"}