Files
colorshell/README.md
T
2025-04-15 17:35:11 -03:00

107 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Retrozinn's Hyprland Dots
> [!note]
> This is very work in progress, it's an Aylur's GTK Shell version of my dots! I absolutely <br>
> don't recommend installing this one, since it's WIP.
> If you're searching for the stable dotfiles, go to the [`ryo`](https://github.com/retrozinndev/Hyprland-Dots/tree/ryo) branch! <br>
My Hyprland dot-files that I keep improving almost everyday! 🤩 (i love doing this) <br>
This repository includes a desktop shell made with [GTK], using [Astal] and [AGS] + [TypeScript].
It really took me a lot of time to make this, so please star the repo if you like it! :star:
### ✔️ What's included in this shell
- Super pretty Bar, Control Center and Clock Window(with calendar and media controller)
- Notifications with support for actions + History
- Internationalization(i18n, see [🌐 Internationalization](#-internationalization) for available languages)
- Bluetooth + Network Controllers
- Bluetooth device management inside Control Center itself
- Runner with support for plugins ([anyrun](https://github.com/anyrun-org/anyrun)-like)
- Super cool media controller
- Gnome-like application runner(the fullscreen one)
- Support for multiple monitors
- Screen Recording support(wf-recorder needed)
## 🔘 TODO
- Per-app Volume
- Maybe a settings app in the future? ✨
## 🌄 Screenshots
![Kitty](repo/shots/kitty.png)
![Widgets](repo/shots/widgets.png)
![Control Center](repo/shots/runner-plugin.png)
![Neovim](repo/shots/neovim.png)
## 🎨 Colors
All the colors of the interface are dynamically generated from your wallpaper!
This is possible by using [pywal16] (fork of pywal), a cli tool to generate color schemes on the fly.
## 🖼️ Wallpapers
When you're at the [Installation](#Installation) process, you can choose whether to install the wallpapers.
Or if you haven't, you can just create a directory `~/wallpapers` in your home `~` and put images you want to use as wallpapers!
You can select any of the images inside `~/wallpapers` by pressing <kbd>SUPER</kbd> + <kbd>W</kbd> or by accessing the
Control Center and clicking in the image icon on top.
### ️ Source
All wallpapers inside this repo are not made by me! You can find all sources inside the [`WALLPAPERS.md`](https://github.com/retrozinndev/Hyprland-Dots/blob/ryo/WALLPAPERS.md) file.
## ⌨️ Binds
You can see pre-configured bindings in the [Wiki/Bindings] page!
## 🌐 Internationalization
This Shell supports i18n. Currently, it supports the following languages:
- English (United States), maintained by [@retrozinndev](https://github.com/retrozinndev)
- Português (Brasil), maintained by [@retrozinndev](https://github.com/retrozinndev)
Don't see your language here? You can contribute and make translations too! <br>
To do so, fork this repository, translate your fork, then open a pull request to this repository, simple as that!
## ⚙️ Installation
See the Installation Guide on [Wiki/Installation].
## 🎉 Tools
- Browser: [Zen Browser]
- Text Editor: [Neovim], my config is [here](https://github.com/retrozinndev/nvim-conf.lua)
- Terminal Emulator: [Kitty]
- Shell: [Nushell]
- See more on the [wiki]!
## ❗ 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](https://github.com/retrozinndev).
## 🌠 Stargazers
Thanks to everyone who starred my project! 💖
[![Stargazers over time](
https://starchart.cc/retrozinndev/Hyprland-Dots.svg?background=%2324292e&axis=%23fafbfc&line=%232dba4e
)](https://starchart.cc/retrozinndev/Hyprland-Dots)
<!-- References of other projects -->
[pywal16]: https://github.com/eylles/pywal16
[zen browser]: https://zen-browser.app
[neovim]: https://neovim.io
[nushell]: https://nushell.sh
[kitty]: https://sw.kovidgoyal.net/kitty
[ags]: https://aylur.github.io/ags
[astal]: https://aylur.github.io/astal
[typescript]: https://typescriptlang.org
[gtk]: https://www.gtk.org
<!-- Web refs -->
[mit license]: https://en.wikipedia.org/wiki/MIT_License
<!-- Tabs -->
[wiki]: https://github.com/retrozinndev/Hyprland-Dots/wiki
[issues]: https://github.com/retrozinndev/Hyprland-Dots/issues
<!-- Wiki Pages -->
[wiki/dependencies]: https://github.com/retrozinndev/Hyprland-Dots/wiki/Dependencies
[wiki/usage]: https://github.com/retrozinndev/Hyprland-Dots/wiki/Usage
[wiki/installation]: https://github.com/retrozinndev/Hyprland-Dots/wiki/Installation
[wiki/bindings]: https://github.com/retrozinndev/Hyprland-Dots/wiki/Bindings
<!-- Actions -->
[new issue]: https://github.com/retrozinndev/Hyprland-Dots/issues/new