{"id":28612627,"url":"https://github.com/jollysleeper/quoterm","last_synced_at":"2025-06-12T00:30:29.680Z","repository":{"id":296755140,"uuid":"865826197","full_name":"jollySleeper/Quoterm","owner":"jollySleeper","description":"🗨️ A CLI tool for Greeting you with beautiful quotes around the day.","archived":false,"fork":false,"pushed_at":"2025-06-01T20:52:24.000Z","size":446,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-02T06:11:33.837Z","etag":null,"topics":["cli","cli-app","greeter","quote","rust"],"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/jollySleeper.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":"2024-10-01T07:45:18.000Z","updated_at":"2025-06-01T20:51:58.000Z","dependencies_parsed_at":"2025-06-03T07:01:34.865Z","dependency_job_id":null,"html_url":"https://github.com/jollySleeper/Quoterm","commit_stats":null,"previous_names":["jollysleeper/quoterm"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/jollySleeper/Quoterm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollySleeper%2FQuoterm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollySleeper%2FQuoterm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollySleeper%2FQuoterm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollySleeper%2FQuoterm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jollySleeper","download_url":"https://codeload.github.com/jollySleeper/Quoterm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollySleeper%2FQuoterm/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259369526,"owners_count":22847091,"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":["cli","cli-app","greeter","quote","rust"],"created_at":"2025-06-12T00:30:28.946Z","updated_at":"2025-06-12T00:30:29.581Z","avatar_url":"https://github.com/jollySleeper.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🗨️ Quoterm\nA CLI tool for greeting you and your terminal with beautiful quotes around the day.\n\n![Quoterm](./screenshot.png)\n\n## 📖 Table of Contents\n\n- [✨ Features](#features)\n- [🚀 Installation](#installation)\n- [🛠️ Usage](#usage)\n- [⚙️ Configuration](#configuration)\n- [🗑️ Uninstall](#uninstall)\n- [🐛 Bugs or Requests](#bugs-or-requests)\n- [🤝 Contributing](#contributing)\n- [📄 License](#license)\n- [🙏 Acknowledgments](#acknowledgments)\n\n## ✨ Features\n\n- **Quotes**: Greets you with random quotes every time you open your terminal.\n- **Reactive**: Formatting changes based on the width of your terminal.\n- **Stay Motivated**: Get motivational \u0026 thought-provoking quotes.\n\n## 🚀 Installation\n\u003e Please note that you should have [Rust](https://rust-lang.org) installed on your system.\n\n- Clone this repo using\n```bash\ngit clone http://github.com/jollySleeper/quoterm.git ~/quoterm \u0026\u0026 cd ~/quoterm\n```\n\n- Run these commands to install\n```bash\ncargo build --release\ncargo install --path .\n```\n\n## 🛠️ Usage\n\u003e Please add `~/.cargo/bin/` to your PATH.\n\n- Append the following snippet to your shell rc file:\n```sh .bashrc/.zshrc\nif type \"quoterm\" \u003e /dev/null; then\n    quoterm \nfi\n```\n\n## ⚙️ Configuration\n\nQuoterm can be customized through a configuration file. The file is automatically created with default values when you first run the program.\n\n### Location\n- Linux/macOS: `~/.config/quoterm/config.json`\n- Windows: `%APPDATA%\\quoterm\\config.json`\n\n### Example Configuration\n```json\n{\n  \"colors\": {\n    \"divider\": \"yellow\",\n    \"quote\": \"blue\",\n    \"author\": \"red\"\n  }\n}\n```\n\n### Available Colors\nBasic Colors:\n- `\"black\"`\n- `\"red\"`\n- `\"green\"`\n- `\"yellow\"`\n- `\"blue\"`\n- `\"magenta\"`\n- `\"cyan\"`\n- `\"white\"`\n\nRGB Colors:\nYou can also specify custom RGB colors using an array of three numbers (red, green, blue) between 0 and 255:\n```json\n{\n  \"colors\": {\n    \"divider\": [255, 128, 0],  // Orange color\n    \"quote\": \"blue\",           // Basic color\n    \"author\": [100, 150, 200]  // Custom blue shade\n  }\n}\n```\n\nYou can find an example configuration file in `config.example.json` in the repository.\n\n## 🗑️ Uninstall\n\nIf you decide to uninstall, we're sorry to hear that `quoterm` didn't meet your expectations. We appreciate your feedback. \nTo uninstall, run `rm ~/.cargo/bin/quoterm` from terminal and delete the Quoterm folder using `rm -r quoterm` command.\n\n## 🐛 Bugs or Requests\n\nIf you encounter any problem(s) feel free to open an [issue](https://github.com/jollySleeper/quoterm/issues/new).\nIf you feel the project is missing a feature, please raise an [issue](https://github.com/jollySleeper/quoterm/issues/new) with `FeatureRequest` as heading.\n\n## 🤝 Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature/YourFeature`).\n3. Make your changes and commit them (`git commit -m 'Add some feature'`).\n4. Push to the branch (`git push origin feature/YourFeature`).\n5. Open a pull request.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/jollySleeper/quoterm/blob/main/LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- This project takes inspiration from [Please](https://github.com/NayamAmarshe/please) and many other similar projects.\n- The quotes displayed by this CLI tool is provided by the JSON File in [Please](https://github.com/NayamAmarshe/please).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjollysleeper%2Fquoterm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjollysleeper%2Fquoterm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjollysleeper%2Fquoterm/lists"}