# Quickshell-powered illogical-impulse
## Current status

It's ready if you don't need localization... so quite likely

## Instructions

- **Installation**: Clone the repo, checkout this branch and run `install.sh`
- **Dolphin fix** so it won't ask which program to open file with every time: `sudo pacman -S archlinux-xdg-menu && XDG_MENU_PREFIX=arch- kbuildsycoca6; sudo ln -s /etc/xdg/menus/plasma-applications.menu /etc/xdg/menus/applications.menu`
- TODO: Update install script to include the above fix

<div align="center">
    <h1>【 end_4's Hyprland dotfiles 】</h1>
    <h3></h3>
</div>

<div align="center"> 

![](https://img.shields.io/github/last-commit/end-4/dots-hyprland?&style=for-the-badge&color=FFB1C8&logoColor=D9E0EE&labelColor=292324)
![](https://img.shields.io/github/stars/end-4/dots-hyprland?style=for-the-badge&logo=andela&color=FFB686&logoColor=D9E0EE&labelColor=292324)
[![](https://img.shields.io/github/repo-size/end-4/dots-hyprland?color=CAC992&label=SIZE&logo=googledrive&style=for-the-badge&logoColor=D9E0EE&labelColor=292324)](https://github.com/end-4/hyprland)
![](https://img.shields.io/badge/issues-skill-green?style=for-the-badge&color=CCE8E9&logoColor=D9E0EE&labelColor=292324) 
</a>

</div>

<div align="center">
    <h2>• overview •</h2>
    <h3></h3>
</div>


 <details> 
  <summary>Notable features</summary>
     
  - **Overview**: Shows open apps. Type to search/calculate/run
  - **AI**: Gemini, Ollama models and more with configuration
  - **Autogenerated colors**: Accessible and beautiful Material colors based on wallpaper
  - **Transparent installation**: Every command is shown before it's run
</details>
<details> 
  <summary>Instructions</summary>

   - **Prerequisite**: Your system works. That's it. You don't have to reinstall your system!
   - **Automatic**, but guided and transparent, installation for Arch(-based) Linux:
   ```bash
   bash <(curl -s "https://end-4.github.io/dots-hyprland-wiki/setup.sh")
   ```
   - **Manual** installation, other distros and more:
     - See the [Wiki](https://end-4.github.io/dots-hyprland-wiki/en/i-i/01setup/)
    
   - **Default keybinds**: Should be somewhat familiar if you've used Windows or GNOME. 
     - For a list, hit `Super`+`/`
     - For a terminal, hit `Super`+`Enter`

</details>

<details>
  <summary>Software overview</summary>


  | Software | Purpose |
  | ------------- | ------------- |
  | [Hyprland](https://github.com/hyprwm/hyprland) | The compositor (for noobs, you can just call it a window manager) |
  | [Quickshell](https://quickshell.outfoxxed.me/) | A QtQuick-based widget system, responsible for the status bar, sidebars, etc. |
  | [Fuzzel](https://mark.stosberg.com/fuzzel-a-great-dmenu-and-rofi-altenrative-for-wayland/) | For clipboard and emoji picker |


  - For a more comprehensive list of dependencies, see [scriptdata/dependencies.conf](https://github.com/end-4/dots-hyprland/blob/main/scriptdata/dependencies.conf)
</details>

<details> 
  <summary>Help improve these dotfiles</summary>

   - Try the Quickshell-powered version at [`ii-qs` branch](https://github.com/end-4/dots-hyprland/tree/ii-qs) - It comes with major improvements, and you're free to make suggestions 👉 [#1276](https://github.com/end-4/dots-hyprland/pull/1276)
   
</details>

<div align="center">
    <h2>• screenshots •</h2>
    <h3></h3>
</div>

## illogical-impulse<sup>Quickshell</sup>

| AI | Common widgets |
|:---|:---------------|
| ![image](https://github.com/user-attachments/assets/08d26785-b54d-4ad1-875b-bb08cc6757f5) | ![image](https://github.com/user-attachments/assets/4fcd63d9-0943-4b21-8737-4bed97b71961) |
| Window management | Weeb power |
| ![image](https://github.com/user-attachments/assets/86cc511b-0d33-4c78-bcc0-3037d02a17da) | ![image](https://github.com/user-attachments/assets/a34a9664-326a-4e66-a643-480d6f7fcc19) |

## illogical-impulse<sup>AGS</sup>

| AI | Common widgets |
|:---|:---------------|
| ![image](https://github.com/user-attachments/assets/9d7af13f-89ef-470d-ba78-d2288b79cf60) | ![image](https://github.com/end-4/dots-hyprland/assets/97237370/406b72b6-fa38-4f0d-a6c4-4d7d5d5ddcb7) |
| Window management | Weeb power |
| ![image](https://github.com/user-attachments/assets/02983b9b-79ba-4c25-8717-90bef2357ae5) | ![image](https://github.com/user-attachments/assets/bbb332ec-962a-4e88-a95b-486d0bd8ce76) |

## Unsupported stuff

- The pics are here mainly for your viewing pleasure
- The files are still available, feel free to grab them from the [`archive`](https://github.com/end-4/dots-hyprland/tree/archive) branch if you're willing to see some spaghetti and troubleshoot
- Click image for a presentation video

### [m3ww](https://github.com/end-4/dots-hyprland/tree/archive)
   <a href="https://streamable.com/85ch8x">
    <img src="https://github.com/end-4/dots-hyprland/assets/97237370/09533e64-b6d7-47eb-a840-ee90c6776adf" alt="Material Eww!">
   </a>

### [NovelKnock](https://github.com/end-4/dots-hyprland/tree/archive)
   <a href="https://streamable.com/7vo61k">
    <img src="https://github.com/end-4/dots-hyprland/assets/97237370/42903d03-bf6f-49d4-be7f-dd77e6cb389d" alt="Desktop Preview">
   </a>

### [Hybrid](https://github.com/end-4/dots-hyprland/tree/archive)
   <a href="https://streamable.com/4oogot">
    <img src="https://github.com/end-4/dots-hyprland/assets/97237370/190deb1e-f6f5-46ce-8cf0-9b39944c079d" alt="click the circles!">
   </a>

### [Windoes](https://github.com/end-4/dots-hyprland/tree/archive)
   <a href="https://streamable.com/5qx614">
    <img src="https://github.com/end-4/dots-hyprland/assets/97237370/b15317b1-f295-49f5-b90c-fb6328b8d886" alt="Desktop Preview">
   </a>

<div align="center">
    <h2>• thank you •</h2>
    <h3></h3>
</div>

 - [@clsty](https://github.com/clsty) for making an actually good install script + many other stuff that I neglect
 - [@midn8hustlr](https://github.com/midn8hustlr) for greatly improving the color generation system
 - Quickshell: [Soramane](https://github.com/caelestia-dots/shell/), [FridayFaerie](https://github.com/FridayFaerie/quickshell), [nydragon](https://github.com/nydragon/nysh)
 - AGS: [Aylur's config](https://github.com/Aylur/dotfiles/tree/ags-pre-ts), [kotontrion's config](https://github.com/kotontrion/dotfiles)
 - EWW: [fufexan's config](https://github.com/fufexan/dotfiles) (he thanks more people there btw)
 - AI bots for providing useful examples

<div align="center">
    <h2>• stonks •</h2>
    <h3></h3>
</div>

- Funny useful number: https://github.com/sponsors/end-4
- Funny useless number:

[![Stargazers over time](https://starchart.cc/end-4/dots-hyprland.svg?variant=adaptive)](https://starchart.cc/end-4/dots-hyprland)

- *Jokes aside i do appreciate both*


<div align="center">
    <h2>• inspirations/copying •</h2>
    <h3></h3>
</div>

 - Inspiration: osu!lazer, Windows 11, Material Design 3, AvdanOS (concept)
 - Copying: The license allows you to. Personally I have absolutely no problem with others redistributing/recreating my work. There's no "stealing" (unless you do weird stuff and violate the license). (this note is here because some people actually asked)