{"id":25631041,"url":"https://github.com/felipefacundes/shell_utils","last_synced_at":"2025-07-28T19:42:39.831Z","repository":{"id":277443397,"uuid":"932448078","full_name":"felipefacundes/shell_utils","owner":"felipefacundes","description":"Shell Utils is an educational framework designed to make shell programming accessible and powerful. It is the result of extensive work over many years, now available on GitHub. With over 280 documented scripts, it caters to both beginners and advanced users. Its main differentiator is the ability to interact with the major shells: Bash, Zsh, Fish","archived":false,"fork":false,"pushed_at":"2025-06-20T02:39:13.000Z","size":25285,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-20T03:34:37.974Z","etag":null,"topics":["bash","cli","cli-app","fish","fish-configuration","hacktoberfest","oh-my-fish","oh-my-zsh","oh-my-zsh-plugin","oh-my-zsh-theme","ohmyzsh","plugin-framework","plugins","productivity","shell","terminal","theme","themes","zsh","zsh-configuration"],"latest_commit_sha":null,"homepage":"https://shellutils.github.io/","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/felipefacundes.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-02-13T23:35:57.000Z","updated_at":"2025-06-20T02:39:16.000Z","dependencies_parsed_at":"2025-06-20T03:35:55.116Z","dependency_job_id":null,"html_url":"https://github.com/felipefacundes/shell_utils","commit_stats":null,"previous_names":["felipefacundes/shell_utils"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/felipefacundes/shell_utils","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Fshell_utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Fshell_utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Fshell_utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Fshell_utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipefacundes","download_url":"https://codeload.github.com/felipefacundes/shell_utils/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipefacundes%2Fshell_utils/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262155574,"owners_count":23267541,"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":["bash","cli","cli-app","fish","fish-configuration","hacktoberfest","oh-my-fish","oh-my-zsh","oh-my-zsh-plugin","oh-my-zsh-theme","ohmyzsh","plugin-framework","plugins","productivity","shell","terminal","theme","themes","zsh","zsh-configuration"],"created_at":"2025-02-22T20:18:25.110Z","updated_at":"2025-06-26T23:09:18.317Z","avatar_url":"https://github.com/felipefacundes.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shell Utils Framework 🐚\n\n[![pt-BR](https://img.shields.io/badge/lang-pt--BR-green.svg)](./README_pt.md) [![es](https://img.shields.io/badge/lang-es-yellow.svg)](./README_es.md) [![en](https://img.shields.io/badge/lang-en-red.svg)](./README.md)\n\n\u003cdiv align=\"center\"\u003e\n  \n![Shell Utils Logo](./icons/logo.png)\n\n*A Dynamic Collection of Shell Scripts with Educational Purpose*\n\n![GitHub stars](https://img.shields.io/github/stars/felipefacundes/shell_utils?style=social)\n![GitHub forks](https://img.shields.io/github/forks/felipefacundes/shell_utils?style=social)\n![GitHub issues](https://img.shields.io/github/issues/felipefacundes/shell_utils)\n![GitHub license](https://img.shields.io/github/license/felipefacundes/shell_utils)\n\n\u003c/div\u003e\n\n## 🌟 Overview\n\nShell Utils is an educational framework designed to make shell programming accessible and powerful. It is the result of extensive work over many years, now available on GitHub. With over 280 documented scripts, it caters to both beginners and advanced users. Its main differentiator is the ability to interact with the major shells: **Bash, Zsh, and Fish**.\n\nThis repo is intended to extend the shell and contain useful and readable functions that help developers to maintaine their scripts easier and neatly.\n\n✅ Includes third-party scripts, such as those from [Fred's Imagemagick](http://www.fmwconcepts.com/imagemagick/index.php) *(credits maintained in the scripts)*.\n\n### ✨ Key Features\n\n- Dynamic recognition of scripts, functions, variables, and aliases\n- Comprehensive documentation and help menus\n- Shell compatibility (fish, zsh, bash)\n- Rich collection of utility scripts\n- Educational resources and tutorials\n\n📌 The `help_shell` script lists functions like `sed_info` (to assist with using sed), providing quick tutorials on Linux commands. To create a simple function, just create a file `function.sh` and store it in `~/.shell_utils/scripts/helps/`. The `help_shell` script will be able to read them and display a complete list of educational functions and much more.\n\n## 📁 Directory Structure\n\n```bash\n~/.shell_utils/\n├── scripts/     # Main scripts\n│   ├── faqs/    # Tutorial scripts and guides\n│   └── helps/   # Educational helper functions\n├── functions/   # Custom functions\n├── variables/   # Environment variables\n└── aliases/     # Shell aliases\n```\n\n## 🔧 Features and Tools\n\n- **Alarm**: Multilingual alarm, capable of executing external commands, snooze function, and more.\n- **Markdown Reader**: An enhanced markdown reader combining clean formatting with optional syntax highlighting.\n- **Calendar**: Full calendar with holiday support\n- **Video Tools**: Screen recorder and video managers\n- **Audio Tools**: Generate audio frequencies and sound managers\n- **Image Processing Tools**: Convert, resize, and manipulate images\n- **Theme Management**:\n  - GRUB themes\n  - Terminal themes\n  - ASCII art collections\n- **Color Utilities**:\n  - ANSI color palette\n  - Hex to ANSI converter\n- **Window Manager Tools**: Support for i3, awesome, openbox, and others\n- **Integration with Third-Party Tools**: Including scripts from [\"Fred's Imagemagick\"](http://www.fmwconcepts.com/imagemagick/index.php)\n\n## 🚀 Installation\n\n### Option 1: One-Line Installation\n```bash\nbash -c \"$(curl -fsSL https://raw.githubusercontent.com/felipefacundes/shell_utils/refs/heads/main/install.sh)\"\n```\n\n### Option 2: Manual Installation\n```bash\ngit clone https://github.com/felipefacundes/shell_utils ~/.shell_utils\nbash ~/.shell_utils/install.sh\n```\n\n## 🔄 Dependencies\n\nThe installer automatically detects your shell (fish, zsh, or bash) and installs the necessary dependencies:\n- For bash users: oh-my-bash\n- For zsh users: oh-my-zsh\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to submit a Pull Request. For significant changes, please open an issue first to discuss what you would like to change.\n\n## 📜 License\n\nThis project is licensed under the GPLv3 License - see the [LICENSE](LICENSE) file for details.\n\n## 👏 Credits\n\n- Original creator: [Felipe Facundes](https://github.com/felipefacundes)\n- Special thanks to all contributors and to [Fred's Imagemagick](http://www.fmwconcepts.com/imagemagick/index.php) for some included scripts\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \n**Made with ❤️ by the Shell Utils community**\n\n[Report Bug](https://github.com/felipefacundes/shell_utils/issues) · [Request Feature](https://github.com/felipefacundes/shell_utils/issues)\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipefacundes%2Fshell_utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipefacundes%2Fshell_utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipefacundes%2Fshell_utils/lists"}