SkillAgentSearch skills...

Dotfiles

📦 Simple yet powerful cross-platform dotfiles. Easily setup the intuitive Ubuntu Desktop, Linux server (Ubuntu/Fedora/Arch Linux), macOS, and Termux.

Install / Use

/learn @irichu/Dotfiles

README

<!-- Languages -->

English / [Japanese(日本語)]

<!-- Logo --> <p align="center"> <a href="https://github.com/irichu/dotfiles"> <img src="https://github.com/user-attachments/assets/44037309-be0e-4cba-88a5-730dcac8cbda" alt="Dotfiles logo image" height="40" > </a> </p> <!-- Badges --> <div align="center"> <p style="width: 80%"> <!-- CODE SIZE --> <img src="https://img.shields.io/github/languages/code-size/irichu/dotfiles?style=for-the-badge&logo=github&color=%2377aaff" alt="GitHub code size in bytes" height="22" > <!-- Tokei LOC --> <a href="https://github.com/irichu/dotfiles"> <img src="https://www.aschey.tech/tokei/github/irichu/dotfiles?style=for-the-badge&logo=https://simpleicons.org/icons/github.svg&color=%2377aaff" alt="Tokei total line" height="22" > </a> <!-- CREATED AT --> <img src="https://img.shields.io/github/created-at/irichu/dotfiles?style=for-the-badge&logo=github&color=%239988FF" alt="GitHub Created At" height="22" > <!-- LAST COMMIT --> <img src="https://img.shields.io/github/last-commit/irichu/dotfiles?style=for-the-badge&logo=github&color=%239988FF" alt="GitHub last commit" height="22" > <!-- LICENSE --> <img src="https://img.shields.io/github/license/irichu/dotfiles?style=for-the-badge&logo=github&color=%2355ff99" alt="GitHub License" height="22" > <!-- RELEASE VERSION --> <img src="https://img.shields.io/github/v/release/irichu/dotfiles?category=lines&style=for-the-badge&logo=github&color=%2355ff99" alt="GitHub Release" height="22" > <!-- STARS --> <img src="https://img.shields.io/github/stars/irichu/dotfiles?style=for-the-badge&logo=github&color=%23ffdd33" alt="GitHub Repo stars" height="22" > </p> </div>

Dotfiles for Linux and Termux

🎉 Welcome

Welcome to my dotfiles. [This GitHub repository] helps easily set up a fast and intuitive desktop and terminal environment. This setup installs Zsh with starship prompt, tmux, Neovim, and Golang and Rust-based command-line tools that starts and operates quickly. I would be delighted if even a single element leads to a new discovery for you. Grateful that you found this project and took a look!

<img src="https://irichu.github.io/dotfiles/assets/images/irichu-dotfiles-ubuntu-desktop-terminal.png" width="800" alt="irichu dotfiles ubuntu desktop terminal">

<img src="https://irichu.github.io/dotfiles/assets/images/irichu-dotfiles-ubuntu-desktop-guiapps.png" width="800" alt="irichu dotfiles ubuntu desktop vscode nautilus">

🚀 Installation

1. Download and Install dotfiles

Use the following curl, wget, or git command:

<details open=""> <summary>curl</summary> <pre> <code class="language-bash">curl -fsSL https://raw.githubusercontent.com/irichu/dotfiles/main/install.sh | bash</code> </pre> </details> <details open=""> <summary>wget</summary> <pre> <code class="language-bash">wget -qO- https://raw.githubusercontent.com/irichu/dotfiles/main/install.sh | bash</code> </pre> </details> <details> <summary>git (>= 2.35.0 recommended)</summary> <pre> <code class="language-bash">git clone --depth=1 https://github.com/irichu/dotfiles.git && cd dotfiles && ./install.sh</code> </pre> </details> <br>

2. Automatic package installation

[!IMPORTANT] On Ubuntu Desktop, automatic setup is possible --ubuntu-desktop.<br> On Ubuntu, fast installation is possible with --apt or --snap.<br> On Linux (Ubuntu/Fedora/Arch Linux) or macOS, automatic setup is available using --brew.<br> On Termux, setup can be done using --pkg.

[!NOTE] On Linux or macOS, sudo access is required for installation.<br> This is needed to install Homebrew itself with --brew and to install packages using --apt, --snap.<br>

Install all components using your preferred package manager: dots install [--apt|--brew|--snap|--pkg]

<!-- Replace `[--apt|--brew|--snap|--pkg]` with your package manager of choice. -->

Examples:

  • To install on Ubuntu Desktop (New):
dots install --ubuntu-desktop
  • To use brew on Linux or macOS:
dots install --brew
  • To use pkg on Termux:
dots install --pkg

[!NOTE] If dots command not found,<br> please run the following command to add the path to ~/.local/bin<br> or use ~/.local/bin/dots command directly during the installation process

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

3. Start

Relogin or execute the following command:

exec -l $(which zsh)

[!NOTE] In a login shell, such as an SSH session, Tmux will start automatically.<br> If a Tmux server is already running, you can select a session to connect to.

✅ Supported OS

  • Linux 🐧
    • Ubuntu 22.04 and newer (recommended)
    • Arch Linux
    • Fedora
  • Mac 🍎
    • macOS
  • Android 📱
    • The latest version of Termux

[!WARNING] The Google Play Store version of Termux may not work properly with some commands.<br> It is recommended to install it from [F-Droid].

<img src="https://irichu.github.io/dotfiles/assets/images/irichu-dotfiles-main-screenshot.png" width="800" alt="irichu dotfiles main screenshot">

<!-- > [!Note] > Some behavior may vary slightly between platforms due to system differences.<br> > -->

✨ Features

  • Desktop
    • Themes
      • Icons: [Flat-Remix-Blue-Dark]
      • Shell: [Marble-blue-dark]
      • GTK: [Flat-Remix-GTK-Blue-Dark-Solid]
    • Gnome Extensions
      • Blur my Shell
      • Just Perfection
      • Space Bar
      • Tactile
      • etc.
  • Terminal
    • Shell: Zsh with the [starship] prompt
    • Editor: [Neovim] configured via [LazyVim]
    • Terminal Multiplexers: [tmux] for session management, [zellij] for workspace management
    • TUI File Managers: [broot] for efficient navigation, [yazi] for rapid file access
    • Terminal Emulator: [Alacritty] for performance, [Termux] for Android environments
<!-- - **Gnome Extensions**: [Blur my Shell], [Just Perfection], [Space Bar], [Tactile], etc. - **Editor**: [VSCode] (Shortcut: Ctrl+Super+Alt+V), preconfigured with ~50 awesome extensions - **Clipboard Manager**: [CopyQ] (Shortcut: Ctrl+Shift+V) - **Screenshot Tool**: [Flameshot] (Shortcut: Ctrl+Super+Alt+F) - **Remote Desktop**: [RustDesk] for simple and secure remote access - **Image Editor**: [GIMP] for advanced image manipulation -->

🐳 Docker

You can build and enter a container with the following commands.

cd ~/.local/share/dotfiles-main

docker compose command:

docker compose up -d --build
docker compose exec dotfiles zsh
<details> <summary>docker command</summary> <pre> <code class="language-bash">docker build -t dotfiles-img . docker run -it -d --name dotfiles-con dotfiles-img docker exec -it dotfiles-con /bin/zsh </code> </pre> </details> <br>

In container, install apt packages

dots install --apt

or install Homebrew with following command.

dots install --brew

📗 Basic commands

<details open=""> <summary>Get/Set the current tmux theme</summary> <pre> <code class="language-bash"># get theme dots tmux-theme</code> </pre> <pre> <code class="language-bash"># set theme dots set-tmux-theme # example dots set-tmux-theme 4 # Set by number dots set-tmux-theme developer-mono # Set by name</code> </pre>

Available themes:

<details open=""> <summary>Developer (purple base)</summary>
  1. developer
<img src="https://github.com/user-attachments/assets/b11d0239-654c-4bb8-8b00-053052bf6551" alt="tmux status image" style="padding-left:30px;"> <br>
  1. developer-textcolored
<img src="https://github.com/user-attachments/assets/eb263ac8-43a4-40b6-9416-d062500ce4db" alt="tmux status image" style="padding-left:30px;"> <br>
  1. developer-colorful
<img src="https://github.com/user-attachments/assets/bdf15c2c-fa79-482e-acc4-d5cff417ea26" alt="tmux status image" style="padding-left:30px;"> <br>
  1. developer-mono
<img src="https://github.com/user-attachments/assets/ff462435-3c49-4671-9ae7-dd5b58e8ddb6" alt="tmux status image" style="padding-left:30px;"> <br> </details> <details> <summary>Turquoise</summary>
  1. dark-turquoise
<img src="https://github.com/user-attachments/assets/04e742ca-9ce8-433b-9b07-19618274d36c" alt="tmux status image" style="padding-left:30px;"> <br>
  1. dark-turquoise-textcolored
<img src="https://github.com/user-attachments/assets/56cccb66-fb8f-4ca3-872b-16ec20abc619" alt="tmux status image" style="padding-left:30px;"> <br>
  1. dark-turquoise-colorful
<img src="https://github.com/user-attachments/assets/bb5f85de-c149-4ad1-a912-ce62c1b62580" alt="tmux status image" style="padding-left:30px;"> <br>
  1. dark-turquoise-mono
<img src="https://github.com/user-attachments/assets/66e21e1b-f1f5-487e-87b0-ad1655e5fd28" alt="tmux status image" style="padding-left:30px;"> <br> </details> <details> <summary>Orange</summary>
  1. dark-orange
<img src="https://github.com/user-attachments/assets/e7a84520-94e6-44c9-ab0e-8c1358123e58" alt="tmux status image" style="padding-left:30px;"> <br>
  1. dark-orange-textcolored
<img src="https://github.com/user-attachments/assets/f9d520d0-8740-4538-ae4e-7e88d77aa10d" alt="tmux status image" style="padding-left:30px;"> <br>
  1. dark-orange-colorful
<img src="https://github.com/user-attachments/assets/5aebc5e0-bef7-451b-9cd0-0f22be945a76" alt="tmux status image" style="padding-left:30px;"> <br>
  1. dark-orange-mono
<img src="https://github.com/user-attachments/assets/4bb9b5b7-e5e1-4865-9a5e-f4e2e4fc2da1" alt="tmux status image" style="padding-left:30px;"> <br> </details> <details> <summary>Skyblue</summary>
  1. dark-skyblue

<img src="https://github.com/user-attachments/assets/2b97e6ef-9510-40b0-8

View on GitHub
GitHub Stars19
CategoryDevelopment
Updated7d ago
Forks2

Languages

Shell

Security Score

95/100

Audited on Mar 16, 2026

No findings