{"id":23777616,"url":"https://github.com/1999azzar/alias-hub","last_synced_at":"2026-06-19T06:32:26.512Z","repository":{"id":269176294,"uuid":"906644436","full_name":"1999AZZAR/alias-hub","owner":"1999AZZAR","description":"This repository contains a categorized collection of shell aliases to boost productivity and simplify common tasks. Each alias file is modular, covering areas like development tools, file management, networking, and more. Perfect for anyone looking to enhance their command-line experience.","archived":false,"fork":false,"pushed_at":"2026-05-10T18:16:37.000Z","size":183,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-05-10T20:19:31.128Z","etag":null,"topics":["alias-manager","aliases-setup","terminal"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/1999AZZAR.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-21T13:42:52.000Z","updated_at":"2026-05-10T18:16:41.000Z","dependencies_parsed_at":"2025-12-04T18:05:33.358Z","dependency_job_id":null,"html_url":"https://github.com/1999AZZAR/alias-hub","commit_stats":null,"previous_names":["1999azzar/alias-hub"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/1999AZZAR/alias-hub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Falias-hub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Falias-hub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Falias-hub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Falias-hub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1999AZZAR","download_url":"https://codeload.github.com/1999AZZAR/alias-hub/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1999AZZAR%2Falias-hub/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34520431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["alias-manager","aliases-setup","terminal"],"created_at":"2025-01-01T08:47:48.927Z","updated_at":"2026-06-19T06:32:26.506Z","avatar_url":"https://github.com/1999AZZAR.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Alias Hub\n\n**Alias Hub** is a comprehensive collection of shell aliases designed to enhance your terminal productivity. This repository organizes aliases into logical categories, making it easy to find and use commands for specific tasks.\n\n## Table of Contents\n\n- [Features](#features)\n- [Getting Started](#getting-started)\n  - [Installation](#installation)\n  - [Installation Options](#installation-options)\n  - [What Gets Installed](#what-gets-installed)\n  - [Updating](#updating)\n  - [System Requirements](#system-requirements)\n- [Usage](#usage)\n  - [Basic Commands](#basic-commands)\n  - [Alias Categories](#alias-categories)\n  - [Configuration](#configuration)\n- [File Overview](#file-overview)\n- [Enhancing Your Terminal Experience](#enhancing-your-terminal-experience)\n- [Customization](#customization)\n- [Troubleshooting](#troubleshooting)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- **Modular Design**: Use only the alias categories you need\n- **Multi-Platform Support**: Works across different Linux distributions and shells\n- **Auto-Detection**: Automatically detects your package manager and shell environment\n- **Comprehensive Coverage**: Includes aliases for development, system management, networking, and more\n- **Easy Installation**: One-command installation with intelligent setup\n- **Backup \u0026 Recovery**: Safe installation with automatic backup and restore capabilities\n- **Tab Completion**: Built-in autocompletion for alias categories\n- **Regular Updates**: Easy update mechanism to stay current with latest aliases\n\n## Getting Started\n\n### Installation\n\nThe Alias Hub installer provides a seamless setup experience with automatic detection of your system environment. Choose one of the installation methods below based on your preference and available tools.\n\n#### Quick Installation Methods\n\n**Using `curl` (Recommended):**\n\n```bash\nbash -c \"$(curl -fsSL https://raw.githubusercontent.com/1999AZZAR/alias-hub/master/install.sh)\"\n```\n\n**Using `wget`:**\n\n```bash\nbash -c \"$(wget -qO- https://raw.githubusercontent.com/1999AZZAR/alias-hub/master/install.sh)\"\n```\n\n**Manual Installation:**\n\n```bash\n# Clone the repository\ngit clone https://github.com/1999AZZAR/alias-hub.git ~/alias-hub\n\n# Navigate to the directory\ncd ~/alias-hub\n\n# Run the installer\n./install.sh\n\n# Run the uninstaller (if needed)\n./uninstall.sh\n```\n\n### Installation Options\n\nThe installer supports various command-line options for different use cases and environments:\n\n```bash\n./install.sh [options]\n```\n\n#### Available Options\n\n| Option            | Description                                               |\n| ----------------- | --------------------------------------------------------- |\n| `--help`        | Show help message and exit                                |\n| `--dry-run`     | Preview installation without making changes               |\n| `--force`       | Force reinstallation, overwriting existing configurations |\n| `--uninstall`   | Remove Alias Hub and restore original configurations      |\n| `--minimal`     | Minimal installation (aliases + config + scripts only)    |\n| `--no-packages` | Skip system package installation                          |\n| `--verbose`     | Enable verbose output for debugging                       |\n| `--shell SHELL` | Override automatic shell detection                        |\n\n#### Installation Examples\n\n```bash\n# Preview installation without making changes\n./install.sh --dry-run\n\n# Force reinstallation (useful for updating)\n./install.sh --force\n\n# Install without system packages (minimal setup)\n./install.sh --no-packages\n\n# Remove Alias Hub completely\n./uninstall.sh\n# or\n./install.sh --uninstall\n\n# Minimal installation (aliases, config, scripts)\n./install.sh --minimal\n\n# Install with verbose output\n./install.sh --verbose\n\n# Force use of specific shell\n./install.sh --shell zsh\n```\n\n### What Gets Installed\n\nThe installer performs the following operations automatically:\n\n1. **Environment Detection**\n\n   - Identifies your package manager (apt, dnf, pacman, apk, zypper, emerge)\n   - Detects your shell environment (bash, zsh, fish, ash, dash)\n   - Checks for required dependencies\n2. **Repository Setup**\n\n   - Downloads Alias Hub to `~/alias-hub`\n   - Creates necessary directory structure\n   - Sets proper file permissions\n3. **Neofetch Configuration**\n\n   - Installs custom Neofetch configuration\n   - Downloads ASCII art collection\n   - Configures display settings\n4. **Package Installation**\n\n   - Installs essential command-line tools:\n     - `eza` - Modern replacement for `ls`\n     - `htop` - Interactive process viewer\n     - `neofetch` - System information tool\n     - `fastfetch` - Alternative system info display\n     - `ncdu` - Disk usage analyzer\n     - `tree` - Directory tree viewer\n     - `glances` - System monitoring\n     - And many more...\n5. **Shell Configuration**\n\n   - Adds Alias Hub sourcing to your shell RC file\n   - Enables tab completion for alias categories\n   - Creates backups of existing configurations\n6. **Autocompletion Setup**\n\n   - Configures tab completion for `alias-list` command\n   - Supports completion for all alias categories\n\n### Updating\n\n#### Automatic Updates\n\nTo update to the latest version, simply re-run the installer:\n\n```bash\n./install.sh\n```\n\nThe installer will:\n\n- Pull the latest changes from the repository\n- Update configurations if needed\n- Install any new required packages\n- Preserve your customizations\n\n#### Manual Updates\n\nFor manual updates:\n\n```bash\ncd ~/alias-hub\ngit pull origin master\n```\n\n### System Requirements\n\n#### Supported Package Managers\n\nAlias Hub supports the following package managers:\n\n- **apt** - Ubuntu, Debian, Linux Mint, Pop!_OS, elementary OS\n- **dnf** - Fedora, RHEL, CentOS, Rocky Linux, AlmaLinux\n- **pacman** - Arch Linux, Manjaro, EndeavourOS, Garuda Linux\n- **apk** - Alpine Linux\n- **zypper** - openSUSE, SUSE Linux Enterprise\n- **emerge** - Gentoo Linux\n\n#### Supported Shells\n\n| Shell              | Configuration File             | Status              |\n| ------------------ | ------------------------------ | ------------------- |\n| **bash**     | `~/.bashrc`                  | Fully Supported     |\n| **zsh**      | `~/.zshrc`                   | Fully Supported     |\n| **fish**     | `~/.config/fish/config.fish` | Fully Supported     |\n| **ash/dash** | `~/.profile`                 | Supported (limited) |\n\n#### Required Tools\n\n- **`git`** - Version control system for cloning and updating\n- **`curl`** or **`wget`** - For downloading remote resources\n- **`sudo`** - Administrative privileges for package installation\n\n#### Minimum System Requirements\n\n- **RAM**: 256MB minimum, 512MB recommended\n- **Storage**: 50MB free space for installation\n- **Network**: Internet connection for package downloads\n\n## Usage\n\nOnce installed, Alias Hub provides immediate access to hundreds of useful aliases. Here are the most common usage patterns:\n\n### Basic Commands\n\nAfter installation, restart your shell or run:\n\n```bash\nsource ~/.bashrc  # For bash users\nsource ~/.zshrc   # For zsh users\n```\n\n#### Core Commands\n\n```bash\n# List all available alias categories\nalias-list\n\n# Show aliases in a specific category\nalias-list system      # System management aliases\nalias-list dev         # Development aliases\nalias-list network     # Network aliases\n\n# Get help for any alias (if available)\nalias-help [alias-name]\n```\n\n### Alias Categories\n\nAlias Hub organizes aliases into logical categories for easy discovery:\n\n#### System Management\n\n```bash\n# System information and monitoring\nneofetch              # Display system information\nfastfetch             # Alternative system info display\nsysinfo               # Detailed system information\nhtop                  # Interactive process viewer\nglances               # System monitoring dashboard\n\n# System maintenance\nupdate-system         # Update all system packages\nclean-system          # Clean system cache and logs\nmemory-check          # Check memory usage\ndisk-usage            # Analyze disk usage\n```\n\n#### Development Tools\n\n```bash\n# Git operations\ngs                    # git status\nga                    # git add\ngc                    # git commit\ngp                    # git push\ngl                    # git log\n\n# Python development\npy                    # python3\npip                   # pip with system packages flag\nvenv-c                # Create virtual environment\nvenv-a                # Activate virtual environment\npytest                # Run tests with pytest\nblack                 # Format code with Black\n\n# Docker operations\ndocker-ps             # Show running containers\ndocker-images         # List Docker images\ndocker-clean          # Clean unused containers/images\n\n# Arduino development\narduino-compile       # Compile Arduino sketch\narduino-upload        # Upload to board\narduino-monitor       # Serial monitor\n\n# ESP development\nesp-build             # Build ESP-IDF project\nesp-flash             # Flash to ESP device\nesp-mon               # Serial monitor\n```\n\n#### File Management\n\n```bash\n# Enhanced listing\nls                    # Colorized, detailed listing (via eza)\nll                    # Long listing format\nla                    # Show hidden files\nlt                    # Tree view of directories\n\n# File operations\ncpv                   # Copy with progress bar\nmvv                   # Move with progress bar\nrsync-copy            # Rsync with common options\nfind-large            # Find large files\n```\n\n#### Network Management\n\n```bash\n# Network information\nmyip                  # Show public IP address\nlocalip               # Show local IP addresses\nips                   # Show all IPs in color\nnetstat-listen        # Show listening ports\nping                  # Ping with 5 packets (default)\n\n# Network tools\nbandwidth             # Internet speed test\ndns-dig               # DNS lookup\nport-scan             # Scan local ports\nwifi-list             # List WiFi networks\n```\n\n#### Database Management\n\n```bash\n# PostgreSQL\npsql                  # Connect to PostgreSQL\npsl                   # List all databases\npgbackup              # Backup database\npgrestore             # Restore database\n\n# Redis\nredis start           # Start Redis server\nredis stop            # Stop Redis server\nredis info            # Show Redis information\nredis-cli             # Open Redis CLI\nredis-get             # Get key value\nredis-set             # Set key value\n```\n\n#### ERP \u0026 Business Tools\n\n```bash\n# Odoo\nodoo                  # Start Odoo and open UI\nodoo stop             # Stop Odoo\nodoo logs             # Show Odoo logs\nodoo status           # Check Odoo status\n```\n\n### Configuration\n\n#### Custom Aliases\n\nAdd your personal aliases to `~/alias-hub/global.alias`:\n\n```bash\n# Example custom aliases\nalias ll='ls -lah'\nalias gs='git status'\nalias ..='cd ..'\nalias ...='cd ../..'\nalias grep='grep --color=auto'\n```\n\n#### Configuration Files\n\nAlias Hub creates the following configuration files:\n\n- `~/.config/neofetch/config.conf` - Neofetch configuration\n- Shell RC files are modified to include Alias Hub sourcing\n\n#### Backup and Restore\n\nAll original configurations are backed up with timestamps:\n\n- Original files: `filename.alias-hub-backup.YYYYMMDD_HHMMSS`\n- Restore backups manually or use `--uninstall` option\n\n---\n\n## File Overview\n\nAlias Hub organizes aliases into categorized files for easy management and selective loading. Each file focuses on a specific domain of terminal operations.\n\n### Core Alias Files\n\n| File                                      | Description                      | Key Features                                                     |\n| ----------------------------------------- | -------------------------------- | ---------------------------------------------------------------- |\n| **`Arduino_CLI.alias`**           | Arduino CLI development          | Board management, core/library installation, compilation, upload |\n| **`Development_Tools.alias`**     | Development and coding shortcuts | Git operations, Python, Docker, build tools, Kubernetes          |\n| **`ESP_Development.alias`**       | ESP32/ESP8266 development        | ESP-IDF tools, flashing, monitoring, configuration               |\n| **`File_Management.alias`**       | File and directory operations    | Enhanced ls, file operations, compression, archive tools         |\n| **`Fun_and_Entertainment.alias`** | Entertainment and leisure        | Games, media, fun commands, ASCII art                            |\n| **`General_Monitoring.alias`**    | System monitoring and analysis   | Hardware monitoring, performance analysis, resource tracking     |\n| **`Github.alias`**                | Git and GitHub operations        | Git shortcuts, GitHub CLI, version control workflows             |\n| **`Media_and_Files.alias`**       | Media file handling              | Audio/video processing, conversion tools, YouTube downloads      |\n| **`Navigations.alias`**           | Directory navigation             | Quick jumps, bookmarks, directory shortcuts                      |\n| **`Network_Management.alias`**    | Network operations               | Connectivity testing, network diagnostics, WiFi management       |\n| **`odoo.alias`**                  | Odoo ERP management              | Service control, logs, status monitoring, virtual environment    |\n| **`Postgres.alias`**              | PostgreSQL database              | Database administration, queries, backups, monitoring            |\n| **`Python.alias`**                | Python development               | Virtual environments, package management, testing, debugging     |\n| **`Redis.alias`**                 | Redis database management        | Server control, data operations, monitoring, pub/sub             |\n| **`Search_Utilities.alias`**      | Search and find operations       | Enhanced grep, find, locate commands, code search                |\n| **`System_Management.alias`**     | System administration            | Updates, monitoring, maintenance tasks, service management       |\n\n### Configuration Files\n\n| File/Directory                              | Purpose                                             |\n| ------------------------------------------- | --------------------------------------------------- |\n| **`config/neofetch/config.conf`**   | Neofetch display configuration                      |\n| **`config/fastfetch/config.jsonc`** | Fastfetch display configuration                     |\n| **`script/helpers.sh`**             | Main helper functions loader (modular architecture) |\n| **`script/sub_scripts/`**           | Modular helper function scripts                     |\n| **`script/system_cleaner.sh`**      | System cleanup automation                           |\n| **`script/update_system.sh`**       | System update automation                            |\n| **`install.sh`**                    | Installation and setup script                       |\n| **`LICENSE`**                       | MIT License file                                    |\n\n### File Details\n\n#### Arduino_CLI.alias\n\nComprehensive Arduino development aliases for embedded systems programming:\n\n- **Board Management**: Board discovery, attachment, selection\n- **Core Management**: Installation for Uno, Nano, Mega, ESP32, ESP8266, and more\n- **Library Management**: Library installation, updates, common libraries\n- **Compilation \u0026 Upload**: Build, verify, and upload commands\n- **Monitoring**: Serial monitor with common baud rates\n- **Quick Workflows**: Board-specific shortcuts and development helpers\n\n#### Development_Tools.alias\n\nContains aliases for common development workflows:\n\n- **Git Operations**: Status, add, commit, push, pull, branching\n- **Docker**: Container management, image operations, networking\n- **Kubernetes**: K8s operations, pod management, deployments\n- **Build Tools**: Make, CMake, compiler shortcuts\n- **Android/iOS**: Mobile development tools\n- **CI/CD**: GitHub Actions, GitLab CI, Jenkins\n- **Cloud Development**: AWS, GCP, Azure CLI tools\n- **Debugging**: Process monitoring, log analysis, error checking\n\n#### ESP_Development.alias\n\nESP32/ESP8266 embedded systems development:\n\n- **Environment Setup**: ESP-IDF initialization and updates\n- **Build Commands**: Compilation, size analysis, component management\n- **Flash Commands**: Upload to devices, erase flash, MAC reading\n- **Monitoring**: Serial monitor, logging, GDB debugging\n- **Configuration**: Menuconfig, partition management\n- **OTA Updates**: Over-the-air update management\n\n#### Github.alias\n\nComprehensive Git and GitHub CLI operations:\n\n- **Quick Shortcuts**: Memory-friendly short aliases (gs, ga, gc, gp)\n- **Descriptive Aliases**: Clear long-form aliases (gstatus, gadd, gcommit)\n- **Branching \u0026 Merging**: Branch operations, merge strategies\n- **Remote Operations**: Push, pull, fetch with various options\n- **GitHub CLI**: Issue management, pull requests, repository operations\n- **Advanced Features**: Stashing, rebasing, cherry-picking, worktrees\n\n#### General_Monitoring.alias\n\nSystem monitoring and performance analysis:\n\n- **Hardware Monitoring**: CPU, GPU, memory, disk information\n- **Process Monitoring**: Process trees, resource usage, top processes\n- **Network Monitoring**: Network statistics, bandwidth usage\n- **Container Monitoring**: Docker and Kubernetes monitoring\n- **Performance Analysis**: System bottlenecks, I/O statistics\n- **Real-time Dashboards**: Live monitoring tools and views\n\n#### odoo.alias\n\nOdoo ERP system management function:\n\n- **Service Control**: Start, stop, restart Odoo service\n- **Service Management**: Enable/disable on boot\n- **Monitoring**: Logs tailing, status checking\n- **Environment**: Python virtual environment activation\n- **Interactive Helper**: Color-coded output with help system\n\n#### Postgres.alias\n\nPostgreSQL database management:\n\n- **Database Operations**: Create, drop, list databases\n- **Connection Management**: Connect to specific databases\n- **Backup \u0026 Restore**: Database backups and restoration\n- **Monitoring**: Process monitoring, database sizes, table analysis\n- **Service Management**: Start, stop, restart PostgreSQL service\n- **Logging**: Access to PostgreSQL logs\n\n#### Python.alias\n\nComprehensive Python development aliases:\n\n- **Package Management**: Pip operations, requirements management\n- **Virtual Environments**: Venv creation, activation, management\n- **Code Quality**: Black, isort, pylint, mypy formatting and linting\n- **Testing**: Pytest, coverage, unittest operations\n- **Debugging**: PDB, profiling, memory analysis\n- **Data Science**: Jupyter, NumPy, Pandas, Matplotlib\n- **Web Development**: Django, Flask, FastAPI commands\n- **Deployment**: Package publishing, Docker integration\n\n#### Redis.alias\n\nRedis database management and operations:\n\n- **Server Management**: Start, stop, restart, status (function wrapper)\n- **Connection \u0026 CLI**: Multiple connection options and CLI modes\n- **Key Operations**: Key management, expiration, scanning\n- **Data Types**: Strings, Hashes, Lists, Sets, Sorted Sets operations\n- **Database Operations**: Database selection, flushing, copying\n- **Monitoring**: Real-time monitoring, slowlog, memory statistics\n- **Persistence**: Backup, restore, save operations\n- **Pub/Sub**: Publish/subscribe messaging\n- **Scripting**: Lua script execution and management\n\n#### System_Management.alias\n\nEssential system administration shortcuts:\n\n- **Package Management**: Update, upgrade, clean, search packages\n- **System Monitoring**: Process viewing, resource usage, system info\n- **Service Management**: Start/stop/restart services, status checks\n- **System Cleanup**: Cache clearing, log rotation, temporary file removal\n- **Backup Operations**: System backup, configuration backup, recovery\n\n#### Network_Management.alias\n\nNetwork diagnostics and management tools:\n\n- **Connectivity Testing**: Ping, traceroute, speed tests\n- **Network Information**: IP addresses, routing tables, DNS lookup\n- **Port Management**: Open ports, listening services, firewall rules\n- **Network Tools**: SSH shortcuts, VPN management, proxy settings\n- **Security**: Network scanning, security audits, encryption tools\n\n#### File_Management.alias\n\nEnhanced file and directory operations:\n\n- **Listing Commands**: Colorized ls, tree views, detailed information\n- **File Operations**: Copy, move, delete with progress indicators\n- **Compression**: Archive creation/extraction, multiple formats\n- **Search \u0026 Find**: File location, content searching, pattern matching\n- **Permissions**: Ownership changes, permission management\n\n#### Search_Utilities.alias\n\nAdvanced search and discovery tools:\n\n- **Text Search**: Enhanced grep with context, file type filtering\n- **File Search**: Find by name, size, date, permissions\n- **Content Analysis**: Binary/hex search, encoding detection\n- **Indexing**: Locate database updates, fast file location\n\n## Enhancing Your Terminal Experience\n\nAlias Hub works best with a well-configured terminal environment. Here are recommendations for enhancing your setup:\n\n### Terminal Emulators\n\nConsider these modern terminal emulators for the best experience:\n\n- **[Alacritty](https://alacritty.org/)**: GPU-accelerated, highly configurable\n- **[Kitty](https://sw.kovidgoyal.net/kitty/)**: Feature-rich with image support\n- **[WezTerm](https://wezfurlong.org/wezterm/)**: Cross-platform with Lua configuration\n- **[GNOME Terminal**](https://wiki.gnome.org/Apps/Terminal): Default for GNOME desktop\n- **[Konsole](https://konsole.kde.org/)**: KDE's powerful terminal emulator\n\n### Shell Frameworks\n\n#### Oh My Bash (for Bash users)\n\n**[Oh My Bash](https://github.com/ohmybash/oh-my-bash)** provides themes and plugins for Bash:\n\n```bash\n# Install Oh My Bash\nsh -c \"$(curl -fsSL https://raw.githubusercontent.com/ohmybash/oh-my-bash/master/tools/install.sh)\"\n\n# Choose a theme (e.g., agnoster, powerline)\n# Edit ~/.bashrc and set: OSH_THEME=\"agnoster\"\n```\n\n#### Oh My Zsh (for Zsh users)\n\n**[Oh My Zsh](https://ohmyz.sh)** is the most popular Zsh framework:\n\n```bash\n# Install Oh My Zsh\nsh -c \"$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)\"\n\n# Install additional plugins\ngit clone https://github.com/zsh-users/zsh-autosuggestions ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions\ngit clone https://github.com/zsh-users/zsh-syntax-highlighting ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting\n```\n\nUpdate your `~/.zshrc`:\n\n```bash\nplugins=(git zsh-autosuggestions zsh-syntax-highlighting)\nZSH_THEME=\"agnoster\"  # or your preferred theme\n```\n\n### Recommended Plugins\n\n#### Zsh Plugins\n\n- **`zsh-autosuggestions`**: Shows command suggestions based on history\n- **`zsh-syntax-highlighting`**: Syntax highlighting for commands\n- **`zsh-completions`**: Additional completion definitions\n- **`fast-syntax-highlighting`**: Faster, more accurate syntax highlighting\n\n#### Bash Plugins\n\n- **`bash-completion`**: Enhanced tab completion\n- **`bash-git-prompt`**: Git status in bash prompt\n- **`bash-preexec`**: Pre-exec and post-exec hooks\n\n### Additional Tools\n\n#### Modern Replacements\n\n```bash\n# Install modern alternatives\nsudo apt install bat ripgrep fd-find fzf  # Ubuntu/Debian\n# or\nsudo dnf install bat ripgrep fd fzf        # Fedora\n# or\nsudo pacman -S bat ripgrep fd fzf          # Arch\n```\n\n- **`bat`**: A cat clone with syntax highlighting\n- **`ripgrep` (rg)**: Fast text search tool\n- **`fd`**: Simple, fast, user-friendly find\n- **`fzf`**: Fuzzy finder for command line\n\n#### Terminal Multiplexers\n\n- **[tmux](https://github.com/tmux/tmux)**: Terminal multiplexer for session management\n- **[screen](https://www.gnu.org/software/screen/)**: Classic terminal multiplexer\n\n#### Text Editors\n\n- **[Neovim](https://neovim.io/)**: Modern Vim-based editor\n- **[micro](https://github.com/zyedidia/micro)**: Modern terminal-based editor\n- **[helix](https://helix-editor.com/)**: Modal editor inspired by Vim\n\n### Color Schemes and Themes\n\n#### Popular Terminal Themes\n\n1. **Dracula**: Dark theme with high contrast\n2. **Nord**: Arctic-inspired color palette\n3. **Gruvbox**: Retro groove colors\n4. **Solarized**: Carefully crafted color scheme\n5. **One Dark**: Inspired by Atom's One Dark theme\n\n#### Font Recommendations\n\n- **Fira Code**: Ligatures and programming symbols\n- **JetBrains Mono**: Carefully crafted monospace font\n- **Cascadia Code**: Microsoft's monospaced font\n- **Hack**: Typeface designed for source code\n- **Source Code Pro**: Adobe's monospaced font\n\n### Performance Optimization\n\n#### Terminal Settings\n\n```bash\n# Disable scrollback for better performance\n# In ~/.inputrc (for readline-based programs)\nset enable-bracketed-paste off\n\n# Optimize shell startup\n# Remove unnecessary commands from shell RC files\n```\n\n#### System Tweaks\n\n```bash\n# Increase inotify watches (for file monitoring)\necho \"fs.inotify.max_user_watches=524288\" | sudo tee -a /etc/sysctl.conf\n\n# Optimize SSD (if applicable)\nsudo systemctl enable fstrim.timer\n```\n\n## Customization\n\n### Personal Aliases\n\nThe `global.alias` file is your personal customization space. Add frequently used aliases here:\n\n```bash\n# Example custom aliases in ~/alias-hub/global.alias\nalias ll='ls -lah --color=auto'\nalias gs='git status --short'\nalias ga='git add'\nalias gc='git commit -m'\nalias gp='git push origin main'\nalias ..='cd ..'\nalias ...='cd ../..'\nalias ....='cd ../../..'\nalias grep='grep --color=auto'\nalias df='df -h'\nalias du='du -h'\nalias mkdir='mkdir -pv'\n```\n\n### Advanced Configuration\n\n#### Conditional Aliases\n\nCreate aliases that work across different systems:\n\n```bash\n# OS-specific aliases\nif [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then\n    alias open='xdg-open'\nelif [[ \"$OSTYPE\" == \"darwin\"* ]]; then\n    alias open='open'\nfi\n\n# Tool-specific aliases (check if tool exists)\ncommand -v bat \u003e/dev/null \u0026\u0026 alias cat='bat'\ncommand -v eza \u003e/dev/null \u0026\u0026 alias ls='eza'\n```\n\n#### Function-Based Aliases\n\nFor complex operations, use functions:\n\n```bash\n# Create a backup function\nbackup() {\n    cp \"$1\" \"$1.backup.$(date +%Y%m%d_%H%M%S)\"\n    echo \"Backup created: $1.backup.$(date +%Y%m%d_%H%M%S)\"\n}\n\n# Git workflow function\ngpush() {\n    local branch=${1:-main}\n    git add .\n    git commit -m \"${2:-Auto commit}\"\n    git push origin \"$branch\"\n}\n```\n\n### Configuration Management\n\n#### Backup Your Customizations\n\n```bash\n# Backup your global.alias before updates\ncp ~/alias-hub/global.alias ~/alias-hub/global.alias.backup\n\n# Or use the installer's backup feature\n./install.sh --dry-run  # Preview changes\n```\n\n#### Sharing Configurations\n\nConsider creating a separate file for work-specific aliases:\n\n```bash\n# Create ~/alias-hub/work.alias\nalias deploy='ansible-playbook deploy.yml'\nalias logs='tail -f /var/log/application.log'\nalias ssh-prod='ssh user@production-server'\n\n# Source it conditionally\n[[ -f ~/alias-hub/work.alias ]] \u0026\u0026 source ~/alias-hub/work.alias\n```\n\n## Troubleshooting\n\n### Common Issues\n\n#### Installation Problems\n\n**Issue**: Package manager not detected\n\n```\nError: No supported package manager found\n```\n\n**Solution**:\n\n```bash\n# Install packages manually\nsudo apt install git curl  # Ubuntu/Debian\n# or\nsudo dnf install git curl  # Fedora\n```\n\n**Issue**: Permission denied during installation\n\n```\nError: Permission denied\n```\n\n**Solution**:\n\n```bash\n# Ensure you have sudo access\nsudo -v\n\n# Or run without package installation\n./install.sh --no-packages\n```\n\n#### Alias Loading Issues\n\n**Issue**: Aliases not available after installation\n\n```\nCommand not found: alias-list\n```\n\n**Solution**:\n\n```bash\n# Reload your shell configuration\nsource ~/.bashrc   # Bash\nsource ~/.zshrc    # Zsh\n\n# Or restart your terminal\n```\n\n**Issue**: Tab completion not working\n\n```\nNo completion for alias-list\n```\n\n**Solution**:\n\n```bash\n# Check if completion is loaded\ncomplete -p alias-list\n\n# Reload completion\nsource ~/.bashrc\n```\n\n#### Neofetch Issues\n\n**Issue**: Neofetch shows errors\n\n```\nError: ASCII art not found\n```\n\n**Solution**:\n\n```bash\n# Reinstall Neofetch ASCII art\ncurl -sSL https://raw.githubusercontent.com/1999AZZAR/neofetch_ascii/master/install.sh | bash\n\n# Or reinstall Alias Hub\n./install.sh --force\n```\n\n### Diagnostic Commands\n\n```bash\n# Check Alias Hub installation\nls -la ~/alias-hub/\ncat ~/.bashrc | grep -A 5 \"Alias Hub\"\n\n# Test package installations\nwhich eza htop neofetch\n\n# Check shell configuration\necho $SHELL\nls -la ~/.bashrc ~/.zshrc\n```\n\n### Getting Help\n\n1. **Check the logs**: Run installer with `--verbose` flag\n2. **Test individual components**: Try sourcing alias files manually\n3. **Check system compatibility**: Verify your OS and shell are supported\n4. **Report issues**: Create an issue on GitHub with system information\n\n### Recovery Procedures\n\n#### Restore from Backup\n\n```bash\n# List available backups\nls -la ~/.bashrc.alias-hub-backup.*\n\n# Restore specific backup\ncp ~/.bashrc.alias-hub-backup.20241212_123000 ~/.bashrc\nsource ~/.bashrc\n```\n\n#### Clean Reinstall\n\n```bash\n# Remove Alias Hub completely\n./uninstall.sh\n\n# Fresh installation\n./install.sh\n```\n\n#### Manual Cleanup\n\nIf automatic uninstall fails:\n\n```bash\n# Remove Alias Hub directory\nrm -rf ~/alias-hub\n\n# Remove from shell configuration\nsed -i '/Alias Hub Configuration/,/End Alias Hub Configuration/d' ~/.bashrc\nsed -i '/Alias Hub Configuration/,/End Alias Hub Configuration/d' ~/.zshrc\n\n# Restore Neofetch config\ncp ~/.config/neofetch/config.conf.alias-hub-backup.* ~/.config/neofetch/config.conf\n```\n\n## Contributing\n\nWe welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.\n\n### Ways to Contribute\n\n#### 1. **Add New Aliases**\n\n- Create aliases for common tasks in your workflow\n- Follow existing naming conventions\n- Add comments explaining complex aliases\n- Test aliases across different systems\n\n#### 2. **Improve Existing Aliases**\n\n- Optimize performance of slow aliases\n- Add error handling and safety checks\n- Update deprecated commands\n- Enhance cross-platform compatibility\n\n#### 3. **Create New Categories**\n\n- Identify underserved areas of terminal work\n- Propose new `.alias` files for specific domains\n- Ensure new categories follow existing patterns\n\n#### 4. **Bug Reports and Fixes**\n\n- Report bugs with clear reproduction steps\n- Include system information and error messages\n- Test fixes across multiple environments\n\n#### 5. **Documentation**\n\n- Improve installation instructions\n- Add usage examples\n- Create tutorials and guides\n- Translate documentation\n\n### Development Workflow\n\n#### Setting Up Development Environment\n\n```bash\n# Fork the repository\ngit clone https://github.com/YOUR_USERNAME/alias-hub.git\ncd alias-hub\n\n# Create a feature branch\ngit checkout -b feature/new-aliases\n\n# Make your changes\n# ... edit files ...\n\n# Test your changes\n./install.sh --dry-run\nsource ~/.bashrc  # Test aliases\n\n# Commit your changes\ngit add .\ngit commit -m \"Add new aliases for [category]\"\n```\n\n#### Code Standards\n\n- **Naming**: Use descriptive, consistent naming for aliases\n- **Comments**: Add comments for complex or non-obvious aliases\n- **Testing**: Test aliases on multiple systems when possible\n- **Safety**: Include safety checks for destructive operations\n\n#### Pull Request Guidelines\n\n1. **Title**: Clear, descriptive title for your changes\n2. **Description**: Explain what your PR does and why\n3. **Testing**: Describe how you tested your changes\n4. **Breaking Changes**: Note any breaking changes\n5. **Screenshots**: Include screenshots for UI changes\n\n### Testing Your Changes\n\n```bash\n# Test in isolated environment\nbash -c 'source ./script/helpers.sh; source ./Development_Tools.alias'\n\n# Check for syntax errors\nbash -n *.alias\n\n# Validate with shellcheck (if available)\nshellcheck install.sh\n```\n\n### Recognition\n\nContributors will be:\n\n- Listed in `CONTRIBUTORS.md`\n- Mentioned in release notes\n- Acknowledged in commit messages\n\n## License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n---\n\n**Enjoy an optimized and productive terminal experience with Alias Hub!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1999azzar%2Falias-hub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1999azzar%2Falias-hub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1999azzar%2Falias-hub/lists"}