João Dias
123 lines
5.4 KiB
Markdown
123 lines
5.4 KiB
Markdown
# colorshell
|
||
<p>(previously retrozinndev/Hyprland-Dots)</p>
|
||
|
||
> [!note]
|
||
> personal dotfiles moved to another repo! see [retrozinndev/Hyprland-Dots](https://github.com/retrozinndev/Hyprland-Dots)
|
||
|
||
My Hyprland desktop shell 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:
|
||
|
||
## 🌄 Screenshots
|
||
|
||
|
||
|
||
|
||
|
||
## 🎨 Colors
|
||
All the shell colors are dynamically generated from your wallpaper!
|
||
This is possible by using [pywal16](fork of the archived [pywal](https://github.com/dylanaraps/pywal) project), a cli tool to generate color schemes on the fly.
|
||
|
||
## 🖼️ Wallpapers
|
||
When you're at the [Installation](#%EF%B8%8F-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
|
||
None of the wallpapers available in this repo are made by me! You can find sources inside the [`WALLPAPERS.md`](/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](#-internationalization) for available languages)
|
||
- Application Runner with support for plugins ([anyrun](https://github.com/anyrun-org/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
|
||
|
||
## ⌨️ 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. <br>
|
||
Currently, there's support for 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>
|
||
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].
|
||
|
||
## 🎉 Tools
|
||
- Browser: [Zen Browser]
|
||
- Text Editor: [Neovim], my config is [here](https://github.com/retrozinndev/nvim-conf.lua)
|
||
- Terminal Emulator: [Kitty]
|
||
- Terminal shell: [Nushell]
|
||
|
||
## ❗ 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! 💖
|
||
[](https://www.star-history.com/#retrozinndev/colorshell&Date)
|
||
|
||
<!-- 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/colorshell/wiki
|
||
[issues]: https://github.com/retrozinndev/colorshell/issues
|
||
|
||
<!-- Wiki Pages -->
|
||
[wiki/dependencies]: https://github.com/retrozinndev/colorshell/wiki/Dependencies
|
||
[wiki/usage]: https://github.com/retrozinndev/colorshell/wiki/Usage
|
||
[wiki/installation]: https://github.com/retrozinndev/colorshell/wiki/Installation
|
||
|
||
<!-- Actions -->
|
||
[new issue]: https://github.com/retrozinndev/colorshell/issues/new
|