https://github.com/christitustech/mybash
My Bash profile - Highly customized Starship Theme - Just imagine Powerlevel10k and Nord Theme had a baby.
https://github.com/christitustech/mybash
Last synced: 21 days ago
JSON representation
My Bash profile - Highly customized Starship Theme - Just imagine Powerlevel10k and Nord Theme had a baby.
- Host: GitHub
- URL: https://github.com/christitustech/mybash
- Owner: ChrisTitusTech
- Created: 2022-09-27T05:15:05.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-28T20:12:56.000Z (3 months ago)
- Last Synced: 2025-05-15T07:03:51.678Z (21 days ago)
- Language: Shell
- Homepage:
- Size: 147 KB
- Stars: 488
- Watchers: 14
- Forks: 213
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# ChrisTitusTech's `.bashrc` Configuration
## Overview
This repository provides a comprehensive `.bashrc` configuration along with supporting scripts and configuration files to enhance your terminal experience in Unix-like operating systems. It configures the shell session by setting up aliases, defining functions, customizing the prompt, and more, significantly improving the terminal's usability and power.
## Table of Contents
- [Installation](#installation)
- [Uninstallation](#uninstallation)
- [Configuration Files](#configuration-files)
- [.bashrc](#bashrc)
- [starship.toml](#starshiptoml)
- [config.jsonc](#configjsonc)
- [Key Features](#key-features)
- [Advanced Functions](#advanced-functions)
- [System-Specific Configurations](#system-specific-configurations)
- [Conclusion](#conclusion)
## Installation
To install the `.bashrc` configuration, execute the following commands in your terminal:
```sh
git clone --depth=1 https://github.com/dacrab/mybash.git
cd mybash
./setup.sh
```
The `setup.sh` script automates the installation process by:
- Creating necessary directories (`linuxtoolbox/mybash`)
- Cloning the repository
- Installing dependencies (bash-completion, neovim, starship, fzf, zoxide)
- Installing the MesloLGS Nerd Font required for the prompt
- Linking configuration files (`.bashrc` and `starship.toml`) to your home directory
- Setting up additional utilities like `fastfetch`
Ensure you have the required permissions and a supported package manager before running the script.
## Uninstallation
To uninstall the `.bashrc` configuration, run:
```sh
cd mybash
chmod +x uninstall.sh
./uninstall.sh
```
The `uninstall.sh` script reverses the installation process by:
- Removing installed dependencies
- Uninstalling fonts
- Removing symbolic links to configuration files
- Deleting the `linuxtoolbox` directory
- Cleaning up additional utilities like `starship`, `fzf`, and `zoxide`
After running the script, it's recommended to restart your shell to apply the changes.
## Configuration Files
### `.bashrc`
The `.bashrc` file defines aliases, functions, and environment variables to enhance your shell experience. Key features include:
- **Aliases**: Shortcuts for common commands (e.g., `alias cp='cp -i'`)
- **Functions**: Custom functions for tasks like extracting archives and copying files with progress
### `starship.toml`
The `starship.toml` file configures the [Starship](https://starship.rs/) prompt, providing a highly customizable and informative shell prompt. It includes:
- **Theme Settings**: Defines colors and symbols for different prompt segments
- **Module Configurations**: Customizes modules like `python`, `git`, `docker_context`, and various programming languages
- **Format Customization**: Structures the layout and truncation of paths for a cleaner look
### `config.jsonc`
The `config.jsonc` file configures [fastfetch](https://github.com/AlexRogalskiy/fastfetch), a system information tool. It includes:
- **Logo and Display Settings**: Customizes the appearance of system logos and separators
- **Modules**: Defines which system information modules to display, such as CPU, GPU, OS, kernel, and uptime
- **Custom Sections**: Adds custom formatted sections for hardware and software information
## Key Features
1. **Aliases and Functions**
- Shortcuts for common commands
- Custom functions for complex operations (e.g., extracting archives, copying with progress)
2. **Prompt Customization and History Management**
- Configures PROMPT_COMMAND for automatic history saving
- Manages history file size and handles duplicates
3. **Enhancements and Utilities**
- Improves command output readability with colors
- Introduces safer file operations (e.g., using `trash` instead of `rm`)
- Integrates Zoxide for easy directory navigation
4. **Installation and Configuration Helpers**
- Auto-installs necessary utilities based on system type
- Provides functions to edit important configuration files
## Advanced Functions
- System information display
- Networking utilities (e.g., IP address checks)
- Resource monitoring tools
## System-Specific Configurations
- Editor settings (NeoVim as default)
- Conditional aliases based on system type
- Package manager-specific commands
## Conclusion
This `.bashrc` configuration offers a powerful and customizable terminal environment suitable for various Unix-like systems. It enhances productivity through smart aliases, functions, and integrated tools while maintaining flexibility for system-specific needs. Whether you're a developer, system administrator, or power user, this setup aims to make your terminal experience more efficient and enjoyable.
For any issues, suggestions, or contributions, please open an issue or pull request in this repository. We welcome community involvement to make this configuration even better!