Files
dotfiles/readme.md
2026-04-19 07:25:54 +00:00

96 lines
2.3 KiB
Markdown

<div align="center">
```
˚ ༘ ⋆。˚ samantha's dotfiles ˚。⋆ ༘ ˚
```
*a cozy hyprland rice for arch linux* 🌸
</div>
---
<div align="center">
```
🌙 night ☀️ day
wallpaper shifts at 7am & 8pm — automatically ✨
```
</div>
<div align="center" style="display:flex; gap:8px;">
<img src="https://git.samantha42.xyz/samantha/dotfiles/raw/branch/master/rice-image/day.jpg" width="50%" alt="day wallpaper"/>
<img src="https://git.samantha42.xyz/samantha/dotfiles/raw/branch/master/rice-image/night.jpg" width="50%" alt="night wallpaper"/>
</div>
---
## 🌷 what's inside
| folder | what it does |
|--------|-------------|
| `hypr/` | hyprland config — the heart of the rice |
| `waybar/` | status bar with day/night wallpaper cycling |
| `kitty/` | terminal emulator config |
| `nvim/` | neovim setup |
| `wofi/` | app launcher styling |
| `mpd/` | music player daemon |
| `fastfetch/` | pretty system info display |
---
## 🍵 setup
> this isn't a full `.config` drop-in — it's a **pick-and-mix**. copy what you like!
```bash
# clone it
git clone https://git.samantha42.xyz/samantha/dotfiles.git
# copy whatever you want into ~/.config/
cp -r dotfiles/hypr ~/.config/
cp -r dotfiles/waybar ~/.config/
# ... and so on
```
---
## ✨ highlights
- **hyprland** centric — smooth, wayland-native tiling wm
- **day/night wallpaper cycle** — switches automatically at 7am and 8pm 🌅
- **autostart** — apps launch silently to their assigned workspaces
- mostly **lua, css & shell** under the hood
---
## ⚠️ heads up
> **monitors are hardcoded!**
> the wallpaper cycle script and `hyprland.conf` reference my specific monitor names/configs.
> before using, check and update these to match your own setup:
> ```bash
> # find hardcoded monitor names in:
> hypr/hyprland.conf
> hypr/wallpaper-cycle.sh # or whatever the script is called
> ```
> run `hyprctl monitors` to see your monitor identifiers.
---
## 💌 notes
- built for **arch linux** (but should work on any distro running hyprland)
- configs are kept minimal and readable — feel free to adapt freely
- if something breaks, it's probably a font or a missing dependency 🙃
---
<div align="center">
*made with love and too many late nights* 🫶
</div>