wlr-sunclock

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 70 Open GitHub ↗

wayland desktop widget to show to the sun's shadows on earth

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](https://raw.githubusercontent.com/sentriz/wlr-sunclock/master/.github/gif.gif)

(demo gif, in reality it updates in real time)

# wlr-sunclock

wayland desktop widget to show to the sun's shadows on earth.  
uses [gtk-layer-shell](https://github.com/wmww/gtk-layer-shell) and the [layer shell protocol](https://github.com/swaywm/wlr-protocols/blob/master/unstable/wlr-layer-shell-unstable-v1.xml) to render on your desktop, behind your windows

| Spring Equinox | Summer Solstice |
|:--|:--|
| ![](https://raw.githubusercontent.com/sentriz/wlr-sunclock/master/.github/spring_equinox.png) |  ![](https://raw.githubusercontent.com/sentriz/wlr-sunclock/master/.github/summer_solstice.png)  |
| **Autumn Equinox** | **Winter Solstice** | 
| ![](https://raw.githubusercontent.com/sentriz/wlr-sunclock/master/.github/autumn_equinox.png) |  ![](https://raw.githubusercontent.com/sentriz/wlr-sunclock/master/.github/winter_solstice.png)  |

## Installation

[![](https://repology.org/badge/vertical-allrepos/wlr-sunclock.svg)](https://repology.org/project/wlr-sunclock/versions)

### From source

pacman -S gtk4-layer-shell gtk4 wayland librsvg

meson build
    sudo ninja -C build install

### From AUR

please see [wlr-sunclock-git](https://aur.archlinux.org/packages/wlr-sunclock-git/)

### From OBS

please see [X11:Wayland/wlr-sunclock](https://build.opensuse.org/package/show/X11:Wayland/wlr-sunclock) for the openSUSE package

### From Fedora Copr

please see [wef/wlr-sunclock](https://copr.fedorainfracloud.org/coprs/wef/wlr-sunclock/) for a Fedora package

## CLI args

```
  -i, --monitor-index=INDEX  monitor to show window on (starts at 0)
  -l, --layer=LAYER          layer (background, bottom, top, overlay)
  -a, --anchors=ANCHORS      string of window anchors (see readme)
  -m, --margins=MARGINS      comma separated margins for window (left, right, top, bottom)
  -w, --width=SIZE           width of the window in pixels
  -n, --colour-land=COLOUR   colour of the land
  -o, --colour-ocean=COLOUR  colour of the ocean
  -?, --help                 Give this help list
      --usage                Give a short usage message
  -v, --version              print version
```

## Anchors

-a tl   -a tr   -a br   -a bl   -a ''   -a tblr
    ┌─┬───┐ ┌───┬─┐ ┌─────┐ ┌─────┐ ┌─────┐ ╔═════╗
    ├─┘   │ │   └─┤ │     │ │     │ │ ┌─┐ │ ║     ║
    │     │ │     │ │   ┌─┤ ├─┐   │ │ └─┘ │ ║     ║
    └─────┘ └─────┘ └───┴─┘ └─┴───┘ └─────┘ ╚═════╝

## Start on boot with sway example

# ~/.config/sway/config

exec wlr-sunclock \
       --margins "0,16,0,16" \
       --width 800 \
       --layer bottom \
       --anchors br \
       --border-width 2 \
       --colour-ocean "#C4B5FD" \
       --colour-land "#6D28D9"

wlr-sunclock

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README