146 lines
4.5 KiB
Markdown
146 lines
4.5 KiB
Markdown
# 🖥️ ParanaOS
|
||
|
||
<!-- Desktop screenshots (actual images) -->
|
||
<p align="center">
|
||
<img src="imgs/260204_17h43m19s_screenshot.png" width="400" alt="Screenshot 1"/>
|
||
<img src="imgs/260204_17h44m14s_screenshot.png" width="400" alt="Screenshot 2"/>
|
||
<img src="imgs/260204_17h44m50s_screenshot.png" width="400" alt="Screenshot 3"/>
|
||
<img src="imgs/260204_17h47m38s_screenshot.png" width="400" alt="Screenshot 4"/>
|
||
<img src="imgs/260204_17h48m01s_screenshot.png" width="400" alt="Screenshot 5"/>
|
||
<img src="imgs/260204_17h49m57s_screenshot.png" width="400" alt="Screenshot 6"/>
|
||
<img src="imgs/260204_17h50m12s_screenshot.png" width="400" alt="Screenshot 7"/>
|
||
<img src="imgs/260204_17h50m28s_screenshot.png" width="400" alt="Screenshot 8"/>
|
||
<img src="imgs/260204_17h50m45s_screenshot.png" width="400" alt="Screenshot 9"/>
|
||
<img src="imgs/260204_17h52m05s_screenshot.png" width="400" alt="Screenshot 10"/>
|
||
</p>
|
||
|
||
---
|
||
|
||
## Overview
|
||
|
||
Welcome to my personal dotfiles repo! This setup uses [Nix Flakes](https://nixos.wiki/wiki/Flakes), modular shell/configuration management, and lightweight scripts to make my Linux environment highly reproducible, beautiful, and easy to customize.
|
||
|
||
**Features:**
|
||
- 🎨 Powerlevel10k Zsh theme
|
||
- 🐚 Modular configs for shell, editor, and more
|
||
- ⚡ Automated install with Nix
|
||
- 🖼️ Wallpapers for a custom look
|
||
- 🛠️ Utility scripts
|
||
- 🔒 Host-specific overrides
|
||
|
||
---
|
||
|
||
## Screenshots
|
||
|
||
<details>
|
||
<summary>Click to expand all screenshots</summary>
|
||
|
||
<p align="center">
|
||
<img src="imgs/260204_17h43m19s_screenshot.png" width="700" alt="Screenshot 1"/>
|
||
<img src="imgs/260204_17h44m14s_screenshot.png" width="700" alt="Screenshot 2"/>
|
||
<img src="imgs/260204_17h44m50s_screenshot.png" width="700" alt="Screenshot 3"/>
|
||
<img src="imgs/260204_17h47m38s_screenshot.png" width="700" alt="Screenshot 4"/>
|
||
<img src="imgs/260204_17h48m01s_screenshot.png" width="700" alt="Screenshot 5"/>
|
||
<img src="imgs/260204_17h49m57s_screenshot.png" width="700" alt="Screenshot 6"/>
|
||
<img src="imgs/260204_17h50m12s_screenshot.png" width="700" alt="Screenshot 7"/>
|
||
<img src="imgs/260204_17h50m28s_screenshot.png" width="700" alt="Screenshot 8"/>
|
||
<img src="imgs/260204_17h50m45s_screenshot.png" width="700" alt="Screenshot 9"/>
|
||
<img src="imgs/260204_17h52m05s_screenshot.png" width="700" alt="Screenshot 10"/>
|
||
</p>
|
||
</details>
|
||
|
||
---
|
||
|
||
## Installation & Setup
|
||
|
||
### Prerequisites
|
||
- **Linux machine** (tested with Arch, Ubuntu; works on most distros)
|
||
- **[Nix](https://nixos.org/download.html)** package manager (see https://nixos.org for install instructions)
|
||
- Optionally: [Home Manager](https://nix-community.github.io/home-manager/) for full home directory integration
|
||
|
||
### Step 1: Clone the repository
|
||
|
||
```sh
|
||
git clone https://github.com/gibbyDev/.dotfiles>.git ~/.dotfiles
|
||
cd ~/.dotfiles
|
||
```
|
||
|
||
### Step 2: Install dependencies with Nix Flakes
|
||
|
||
If you don’t have flakes enabled, run:
|
||
|
||
```sh
|
||
nix --experimental-features 'nix-command flakes' flake show
|
||
```
|
||
|
||
Run the installer to rebuild system and home manager modules:
|
||
|
||
```sh
|
||
chmod +x install.sh
|
||
./install.sh
|
||
```
|
||
|
||
Replace `<your-host>` with your hostname as defined in the `hosts/` directory.
|
||
|
||
### Step 3: Extras and Customization
|
||
- Edit (or override) configs in `modules/` for shell, editor, etc.
|
||
- Change wallpapers by replacing files in `wallpapers/`
|
||
- Update host-specific settings in `hosts/`
|
||
- Zsh theme: `.p10k.zsh` config for Powerlevel10k is included
|
||
- Additional scripts can be run or extended from `scripts/`
|
||
|
||
---
|
||
|
||
## Directory Structure
|
||
|
||
```text
|
||
.
|
||
├── flake.lock
|
||
├── flake.nix
|
||
├── hosts
|
||
│ └── template/
|
||
├── imgs
|
||
├── modules
|
||
│ ├── code/
|
||
│ ├── default.nix
|
||
│ ├── dolphin/
|
||
│ ├── fastfetch/
|
||
│ ├── firefox/
|
||
│ ├── hyprland/
|
||
│ ├── kitty/
|
||
│ ├── misc/
|
||
│ ├── nvim/
|
||
│ ├── opencode/
|
||
│ ├── rofi/
|
||
│ ├── tmux/
|
||
│ ├── virtualization/
|
||
│ ├── waybar/
|
||
│ ├── wlogout/
|
||
│ └── yazi/
|
||
├── .p10k.zsh
|
||
├── README.md
|
||
├── scripts
|
||
└── wallpapers
|
||
```
|
||
|
||
---
|
||
|
||
## FAQ & Troubleshooting
|
||
- **How do I update everything?**
|
||
- Pull latest: `git pull`
|
||
- Re-run the Nix install process
|
||
- **Where do I put overrides for my machine?**
|
||
- Add files to the `hosts/` directory named after your hostname.
|
||
- **How do I contribute or fork?**
|
||
- Make your edits, then push to your fork or PR as needed!
|
||
|
||
---
|
||
|
||
## License
|
||
MIT (or specify your own preferred license)
|
||
|
||
## Credits
|
||
Big thanks to the Nix, Home Manager, and Powerlevel10k communities!
|
||
|
||
---
|