{"id":14982833,"url":"https://github.com/mr3rf1/mrzsh","last_synced_at":"2025-10-29T18:31:32.597Z","repository":{"id":215900637,"uuid":"740001315","full_name":"Mr3rf1/MrZsh","owner":"Mr3rf1","description":"A bash script to install and config zsh, oh-my-zsh, zsh-syntax-highlighting, zsh-autosuggestions and neofetch  in any linux distro automatically.","archived":false,"fork":false,"pushed_at":"2024-07-23T15:58:33.000Z","size":24,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-12T02:01:36.095Z","etag":null,"topics":["linux-shell","neofetch","oh-my-zsh","ohmyzsh","shell","zhsrc","zsh","zsh-cus","zsh-plugin","zshell"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mr3rf1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-07T07:52:44.000Z","updated_at":"2024-07-23T15:58:36.000Z","dependencies_parsed_at":"2024-07-23T18:23:51.681Z","dependency_job_id":"3b138dd4-f261-45b8-91e7-331e3b32bb0d","html_url":"https://github.com/Mr3rf1/MrZsh","commit_stats":null,"previous_names":["e811-py/shellconfig","e811-py/mrzsh","mr3rf1/mrzsh"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr3rf1%2FMrZsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr3rf1%2FMrZsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr3rf1%2FMrZsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr3rf1%2FMrZsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mr3rf1","download_url":"https://codeload.github.com/Mr3rf1/MrZsh/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219857402,"owners_count":16556067,"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":["linux-shell","neofetch","oh-my-zsh","ohmyzsh","shell","zhsrc","zsh","zsh-cus","zsh-plugin","zshell"],"created_at":"2024-09-24T14:06:16.684Z","updated_at":"2025-10-29T18:31:32.593Z","avatar_url":"https://github.com/Mr3rf1.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MrZsh 🚀\n\nA powerful bash script that automatically installs and configures a modern Zsh environment with Oh My Zsh, syntax highlighting, autosuggestions, and system information display across multiple Linux distributions.\n\n## ✨ Features\n\n- **Universal Package Manager Support**: Automatically detects and uses the appropriate package manager\n  - Debian/Ubuntu (`apt-get`)\n  - RHEL/CentOS (`yum`)\n  - Fedora (`dnf`)\n  - Arch Linux (`pacman`)\n  - Termux (`pkg`)\n- **Complete Zsh Setup**: Installs Zsh and sets it as the default shell\n- **Oh My Zsh Integration**: Installs the popular Zsh framework\n- **Enhanced Plugins**:\n  - `zsh-autosuggestions`: Fish-like autosuggestions for Zsh\n  - `zsh-syntax-highlighting`: Real-time syntax highlighting\n- **Beautiful Theme**: Configures the \"bira\" theme for a modern look\n- **System Info**: Includes Neofetch for stylish system information display\n- **Smart Installation**: Checks for existing installations to avoid conflicts\n\n## 📋 Prerequisites\n\n- Linux-based operating system\n- Internet connection for downloading packages\n- `sudo` privileges for package installation\n\n## 🚀 Quick Start\n\n### One-Line Installation\n\n```bash\nbash MrZsh.sh\n```\n\n### Step-by-Step\n\n1. **Clone or download the script**:\n   ```bash\n   wget https://raw.githubusercontent.com/yourusername/MrZsh/main/MrZsh.sh\n   # or\n   curl -O https://raw.githubusercontent.com/yourusername/MrZsh/main/MrZsh.sh\n   ```\n\n2. **Make it executable**:\n   ```bash\n   chmod +x MrZsh.sh\n   ```\n\n3. **Run the script**:\n   ```bash\n   ./MrZsh.sh\n   ```\n\n## 🔧 What Gets Installed\n\n| Component | Description | Purpose |\n|-----------|-------------|---------|\n| **Zsh** | Z Shell | Modern shell with advanced features |\n| **Oh My Zsh** | Zsh framework | Plugin and theme management |\n| **zsh-autosuggestions** | Autocompletion plugin | Fish-like command suggestions |\n| **zsh-syntax-highlighting** | Syntax highlighting | Real-time command validation |\n| **Neofetch** | System info tool | Beautiful system information display |\n| **Git** | Version control | Required for Oh My Zsh plugins |\n| **Curl** | HTTP client | Required for downloading components |\n\n## ⚙️ Configuration Details\n\nThe script automatically configures your `.zshrc` file with:\n\n- **Theme**: `bira` - A clean, informative theme\n- **Plugins**: `git`, `zsh-autosuggestions`, `zsh-syntax-highlighting`\n- **Startup**: Neofetch display on terminal launch\n- **Default Shell**: Sets Zsh as your default shell\n\n## 🖥️ Supported Distributions\n\n| Distribution Family | Package Manager | Status |\n|-------------------|-----------------|--------|\n| Debian/Ubuntu | `apt-get` | ✅ Supported |\n| RHEL/CentOS | `yum` | ✅ Supported |\n| Fedora | `dnf` | ✅ Supported |\n| Arch Linux | `pacman` | ✅ Supported |\n| Termux (Android) | `pkg` | ✅ Supported |\n\n## 🛡️ Safety Features\n\n- **Duplicate Detection**: Checks if components are already installed\n- **Graceful Handling**: Skips installation if packages already exist\n- **Error Reporting**: Clear error messages with colored output\n- **Non-Destructive**: Preserves existing configurations when possible\n\n## 🎨 Customization\n\nAfter installation, you can customize your setup by editing `~/.zshrc`:\n\n```bash\n# Change theme\nZSH_THEME=\"your-preferred-theme\"\n\n# Add more plugins\nplugins=(git zsh-autosuggestions zsh-syntax-highlighting your-plugin)\n\n# Remove neofetch if not desired\n# Comment out or remove the 'neofetch' line\n```\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n1. **Permission Denied**:\n   ```bash\n   chmod +x MrZsh.sh\n   ```\n\n2. **Package Manager Not Found**:\n   - Ensure you're running on a supported Linux distribution\n   - Check if your package manager is in PATH\n\n3. **Network Issues**:\n   - Verify internet connection\n   - Check if firewall allows HTTP/HTTPS connections\n\n4. **Sudo Issues**:\n   - Ensure your user has sudo privileges\n   - Try running with `sudo bash MrZsh.sh` if needed\n\n### Manual Cleanup\n\nIf you need to remove the installation:\n\n```bash\n# Remove Oh My Zsh\nrm -rf ~/.oh-my-zsh\n\n# Reset shell to bash\nchsh -s /bin/bash\n\n# Remove .zshrc (backup first!)\nmv ~/.zshrc ~/.zshrc.backup\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit issues, feature requests, or pull requests.\n\n### Development\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Test on multiple distributions\n5. Submit a pull request\n\n## 📝 License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n## 🙏 Acknowledgments\n\n- [Oh My Zsh](https://ohmyz.sh/) - The amazing Zsh framework\n- [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions) - Fish-like autosuggestions\n- [zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting) - Syntax highlighting plugin\n- [Neofetch](https://github.com/dylanaraps/neofetch) - System information tool\n\n## 📞 Support\n\nIf you encounter any issues or have questions:\n\n1. Check the [Troubleshooting](#-troubleshooting) section\n2. Search existing [Issues](https://github.com/yourusername/MrZsh/issues)\n3. Create a new issue with detailed information about your system and the problem\n\n---\n\n**Made with ❤️ for the Linux community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr3rf1%2Fmrzsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmr3rf1%2Fmrzsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr3rf1%2Fmrzsh/lists"}