Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stardust-kyun/calla
Calla Desktop Environment
https://github.com/stardust-kyun/calla
awesomewm calla dotfiles linux
Last synced: 6 days ago
JSON representation
Calla Desktop Environment
- Host: GitHub
- URL: https://github.com/stardust-kyun/calla
- Owner: Stardust-kyun
- Created: 2021-07-03T17:53:13.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-23T03:04:03.000Z (2 months ago)
- Last Synced: 2024-12-28T12:03:47.208Z (27 days ago)
- Topics: awesomewm, calla, dotfiles, linux
- Language: Lua
- Homepage:
- Size: 111 MB
- Stars: 627
- Watchers: 7
- Forks: 18
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Calla
---
---
## Install
### Read Before Installing
In my previous work, I have provided scripts to make it much easier for the average user to install. However, I have found that these scripts are a massive pain to maintain for a variety of distributions, so this time I have provided universal instructions instead. These instructions have been written based on my Debian installation, so you may find that you have additional steps. If you have any questions, see contact.
Installation
---
# Under Construction
Installation instructions are currently being revised as Calla is packaged for major distros. As of version 0.3.0-1, only Debian is supported. If you are attempting to install Calla on Debian, find the newest release in the releases tab. If you are attempting to install on other distros, make sure you have the following installed:
- AwesomeWM git
- Your distribution's package equivalents for line 4 of `DEBIAN/control` (the line that starts with `Depends:`)
Calla currently comes pre-packaged with a version of AwesomeWM git for Debian. To avoid issues, remove the `usr/local` directory of this repo as well as the `calla-awesome` and `calla-awesome-client` files in `usr/bin`. You will need to edit `usr/bin/calla` to run `awesome` instead of `calla-awesome`. Once this is complete, all you should need to do is copy the `usr` directory to your root directory, merging it with your current `usr` directory.
---
## Usage
Settings App
---
Calla contains a settings app to configure itself without editing any files. It can be opened through the settings icon in the control center, or by pressing `Mod+Shift+C`.
### General
- Terminal - The terminal to run on `Mod+Enter`
- Shutdown/Reboot - The commands to use to shutdown and reboot the system
- Fallback Password - The password Calla will use if it cannot use your user's password
- Font(s) - Fonts used throughout the desktop environment
- Battery - The name of your system's battery (found in `/sys/class/power_supply/`
- Wallpaper - If you would like to overwrite the theme's default wallpaper
- Screenshot Directory - The directory that screenshots are saved to
### Theme
- Color Scheme - The theme Calla will use
- Colors - The colors the theme will use, in base8
- Compositor Settings - Settings for the shadow picom sets
- Gui/Icon Theme - The names of the gui and icon themes the theme should use
---
## Gallery
Screenshots
---
### Apps
### Launcher
### Tag Preview
### Volume/Brightness Popup
### Lock Screen
---
## Credit
### Thanks
- [Sammy](https://github.com/TorchedSammy) for help understanding and adding live reloading.
- [Crylia](https://github.com/Crylia) for massive amounts of help learning awesomewm.
- [Jimmy](https://github.com/Jimmysit0) and [Petrolblue](https://github.com/petrolblue) for help with color schemes and lots of support.
- And the support of many more!
### Historical Contributions
- [AloneERO](https://gitlab.com/AloneER0) for help adding support for Void, Fedora, OpenSUSE, and Alpine!
- [Frankfut](https://github.com/frankfutlg) for help adding support for Void and lots of help with debugging.
- [Qwickdom](https://github.com/Qwickdom) for help adding support for Arch.
- [Reverse](https://github.com/Reversedc) for help adding support for Debian.
- [Alyssa](https://github.com/alyssa-sudo) for help adding support for Gentoo.
### References
- [Sammy's Dotfiles](https://github.com/TorchedSammy/dotfiles)
- [Saimoom's Dotfiles](https://github.com/saimoomedits/dotfiles)
- [Smeueg's Dotfiles](https://github.com/Smeueg/Dotfiles)
- [Bling](https://github.com/BlingCorp/bling)
### Projects
- [Phocus](https://github.com/phocus/gtk)
## Contact
You can find my contact information on my [website](https://star.is-a.dev/). I also have a [discord server](https://discord.gg/38hQb6V8AW) with help available and updates for when new features are added.
## Stars
