Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/okitavera/clearine
Beautiful Logout UI for X11 window manager
https://github.com/okitavera/clearine
gtk3 logout python x11
Last synced: about 2 months ago
JSON representation
Beautiful Logout UI for X11 window manager
- Host: GitHub
- URL: https://github.com/okitavera/clearine
- Owner: okitavera
- License: mit
- Archived: true
- Created: 2018-03-15T12:38:36.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-12-08T03:15:54.000Z (almost 5 years ago)
- Last Synced: 2024-05-18T22:11:54.020Z (4 months ago)
- Topics: gtk3, logout, python, x11
- Language: Python
- Homepage:
- Size: 60.5 KB
- Stars: 100
- Watchers: 3
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-linux-customization - **clearine** - Beautiful logout UI for X11 window manager (Logout Screen)
README
# Clearine
Beautiful Logout UI for X11 window manager.
Inspired from oblogout and Android Oreo's power menu.
## Preview
* [Horizontal mode](https://user-images.githubusercontent.com/9277632/47901195-29e2bd00-de77-11e8-8ffc-0d422161bea4.png)
* [Vertical mode](https://user-images.githubusercontent.com/9277632/47901203-2ea77100-de77-11e8-8b85-321c7b2e8bfd.png)
## Dependencies
- python (version 3)
- python-gobject
- python-cairo
## Installation
For Arch user, you can install it via AUR insteads:
$ yaourt -S clearine-git
For Void user :
$ sudo xbps-install -S clearine
---
## Install from source
Install the dependencies first:
$ sudo pacman -S python-cairo python-gobject # Arch Linux
clone this repo into your local storage:
$ git clone https://github.com/yuune/clearine.git
$ cd clearine
then install via pip:
$ pip install .
if you not using pip, you can run setup.py directly:
$ python3 setup.py install --prefix=/usr --root="/" --optimize=1
## Configuration file
Clearine basically read configuration from "~/.config/clearine.conf" .
if that file is unavailable, clearine will read from "/etc/clearine.conf" or "/usr/share/clearine/clearine.conf" insteads.
## Configuration format
The configuration format is using section-style like this :
```
[main]
# set background opacity
opacity = 0.8
# set gaps
gap-left = 70
gap-right = 70
gap-top = 70
gap-bottom = 70
# set mode (vertical/horizontal)
mode = horizontal
# set spacing between card and widget
spacing = 20
[command]
# set command to launch when the button is clicked
logout = openbox --exit
lock = i3lock
restart = systemctl reboot
shutdown = systemctl poweroff
[shortcuts]
cancel = Escape
lock = K
suspend = P
hibernate = H
logout = L
restart = R
shutdown = S
[card]
# set background color and border radius for card
background-color = #e1e5e8
border-radius = 5
# set padding
padding-bottom = 10
padding-left = 10
padding-right = 10
padding-top = 10
[button]
# button theme name
theme = Clearine-Fallback
# button item sort
items = logout, lock, restart, shutdown, cancel
# set button text font and text color
label-font = DejaVu Sans Book 9
label-size = 9
label-color = #101314
# set button width and height
width = 70
height = 70
# set button icon width and height
icon-width = 32
icon-height = 32
# set per-button margin
margin-bottom = 0
margin-left = 0
margin-right = 0
margin-top = 0
# set spacing between button
spacing = 0
# opacity
opacity-normal = 0.7
opacity-focus = 1.0
[widget]
# set widget first line font, size, color and format
firstline-font = DejaVu Sans ExtraLight
firstline-size = 90
firstline-color = #e1e5e8
firstline-format = %H.%M
# set widget second line font, size, color and format
secondline-font = DejaVu Sans Book
secondline-size = 14
secondline-color = #e1e5e8
secondline-format = %A, %d %B %Y
```
For the color, you can use hex format like this :
```
[card]
background-color = #e1e5e8
```
or you can get color from your X resources, by using format like this:
```
[card]
background-color = {background}
[widget]
firstline-color = {color6}
```
## Themes
You can use the png or svg for the icon button.
See `/usr/share/themes/Clearine-Fallback` for example
## Credits
* [Google Material Design Icon Family](https://google.github.io/material-design-icons/)
* [@fikriomar26](https://github.com/fikriomar16)
## License
The code is available under the [MIT license](LICENSE).