colorshell

(previously retrozinndev/Hyprland-Dots)

Warning

AGS v3 is going to be an official release soon(for now, it's only in the main branch)
I'm currently migrating this shell to the new AGS version. More info in #12.

Note

My personal dotfiles are now on retrozinndev/Hyprland-Dots

My Hyprland Desktop Shell that I love to keep improving every day! 🤩

This is the repository for my desktop shell, made with GTK, Astal and AGS + TypeScript.
It really took me a lot of time to make this, so please star the repo if you like it! ⭐

🌄 Screenshots

🎨 Colors

All the shell colors are dynamically generated from your wallpaper! This is possible by using pywal16(fork of the archived pywal project), a cli tool to generate color schemes on the fly.

🖼️ Wallpapers

When you're at the Installation process, you can choose whether you want to install the wallpapers or not.
If you chose to not, either define the $WALLPAPERS variable in your hyprland user configuration to your wallpapers folder, or create the ~/wallpapers directory.

You can select any of the images inside ~/wallpapers by pressing SUPER + W or by accessing the Control Center and clicking in the image icon on top.

ℹ️ Source

None of the wallpapers available in this repo are made by me! You can find sources inside the WALLPAPERS.md file. (it took me a lot of time to make this sources list 😭)

✔️ What's included in this shell

• Pretty Top-Bar
  • Apps button(basically the "start menu", opens the full-screen app launcher)
  • Workspace indicator(contains icon of last used application on each)
  • Focused Client(Window) information(title, class and icon)
  • Clock(with date)
  • Media(shows only when media is being played)
  • Tray(Applications running in the background)
  • Status (volume information, bluetooth, network and notification status)
• Control Center
  • Volume Controls (Microphone and Speaker)
    • Volume Mixer(per-app volume)
  • Pages(the thing that shows up when you click the arrow on a tile)
    • Bluetooth devices
    • Network devices
    • Night Light controls
  • Tiles
    • Screen Recording
    • Bluetooth
    • Night Light
    • Network(wifi needs work, i don't have wifi in my machine)
    • Don't Disturb(disables notification popups)
• Center Window(clock, calendar + media management)
• Notifications with support for application actions + Notification History
• Localization(see 🌐 Internationalization for available languages)
• Application Runner with support for plugins (anyrun-like)
  • Shell(!): Run shell commands with the user shell
  • Clipboard(>): Search through your clipboard history
  • Wallpapers(#): Search and select to change wallpaper
  • Media(:): Control playing media
  • Search(?): Search something on the internet with your default browser
• Gnome-like application list
• Support for your multiple monitors
• Dynamic support for UWSM(dinamically enabled if current session is using UWSM)

⌨️ Binds

You can see default bindings and usage information on the Wiki/Usage page!

🌐 Internationalization

Colorshell supports i18n! The shell automatically matches the shell language with the system's, if available.
Currently, there's support for the following languages:

• English (English, United States), maintained by @retrozinndev
• Português (Portuguese, Brazil), maintained by @retrozinndev
• Русский (Russian), maintained by @NotMephisto

Don't see your language here? You can contribute and make translations too!
You can do so by forking this repository, translating the shell in your fork and then opening a pull request to this repository, simple as that! (I'll create a more detailed guide for that soon)

⚙️ Installation

See the Installation Guide on Wiki/Installation.

❗ Issues

Having issues? Please create a new Issue here, I'll be happy to help you out!

📜 License

This repo is licensed under the MIT License, project is made and maintained by retrozinndev.

🌠 Stargazers

Thanks to everyone who starred my project! 💖