wlapse

KO | EN

gitlite — search

#terminal #machine-learning #developer-tools #llm #video #rag #data-science #css #java #codex

(★ 9)

A stopwatch overlay for Wayland that can be turned on and off with a keybind.

파일 탐색기

ZIP 다운로드

- - ci.yml
  - release.yml
- wlapse.gif
- wlapse.desktop
- wlapse.svg
- - test_build_appimage.py
  - test_prepare_release.py
- build_appimage.py
- prepare_release.py
- clock.rs
- config.rs
- instance.rs
- lib.rs
- main.rs
- placement.rs
- render.rs
- wayland.rs
- cli.rs
- config.rs
- placement.rs
.gitignore
Cargo.lock
Cargo.toml
LICENSE
README.md
RELEASING.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A stopwatch overlay for Wayland that can be turned on and off with a keybind.

![wlapse stopwatch demo](https://raw.githubusercontent.com/fib-nm/wlapse/main/assets/wlapse.gif)

## Key Features

- Can be turned on and off with a keybind.
- Doesn't require daemon or autostart.
- Can be moved by dragging it with the left mouse button.
- Remembers its position between runs.
- Supports custom background and text colors.
- Works with Sway, Hyprland, Niri, and KDE Plasma.

## Requirements

- Linux with an active Wayland session.
- A compositor that supports `wlr-layer-shell` and `relative-pointer-v1`.
- Rust 1.98 or newer and Cargo to build from source.

X11 and compositors without Layer Shell, including GNOME, are not supported.

## Install

### Arch Linux (AUR)

Install the official AUR package:

```sh
paru -S wlapse
```

### AppImage

Download the x86_64 AppImage from the
[latest release](https://github.com/fib-nm/wlapse/releases/latest), then install it
for your user (replace `X.Y.Z` with the downloaded version):

```sh
install -Dm755 wlapse-vX.Y.Z-x86_64.AppImage "$HOME/.local/bin/wlapse"
```

Make sure `$HOME/.local/bin` is in `PATH`. To update wlapse later, replace this file
with the AppImage from the newer release. Running an AppImage normally requires
FUSE. On systems where FUSE is unavailable, use its extraction fallback:

```sh
APPIMAGE_EXTRACT_AND_RUN=1 wlapse
```

### Release

Download the latest release from the
[latest release](https://github.com/fib-nm/wlapse/releases/latest), then extract and
install the binary (replace `X.Y.Z` with the downloaded version):

```sh
tar -xf wlapse-vX.Y.Z-x86_64-unknown-linux-gnu.tar.xz
install -Dm755 wlapse-vX.Y.Z-x86_64-unknown-linux-gnu/wlapse "$HOME/.local/bin/wlapse"
```

Make sure `$HOME/.local/bin` is in `PATH`.

To verify an AppImage or archive before installing it, also download `SHA256SUMS`
from the release, keep it beside the downloaded file, and run:

```sh
sha256sum --check --ignore-missing SHA256SUMS
```

### Build from source

```sh
git clone https://github.com/fib-nm/wlapse.git
cd wlapse
cargo build --release --locked
install -Dm755 target/release/wlapse "$HOME/.local/bin/wlapse"
```

## Usage

Bind the command `wlapse` to any unused key combination. The examples below use
<kbd>Super</kbd>+<kbd>T</kbd>.

### Sway

Add this to your Sway config:

```text
bindsym $mod+t exec wlapse
```

### Hyprland

Add this to `hyprland.lua`:

```lua
hl.bind("SUPER + T", hl.dsp.exec_cmd("wlapse"))
```

### Niri

Add this inside the `binds` section of your Niri config:

```kdl
Mod+T { spawn "wlapse"; }
```

### KDE Plasma

Open **System Settings → Keyboard → Shortcuts**, choose
**Add New → Command or Script**, enter `wlapse` as the command, and assign your
preferred shortcut.

Reload your compositor configuration if it does not apply the new binding
automatically.

### Command line

You can also invoke the same command from a terminal for testing:

```sh
wlapse
```

Show command help or the installed version:

```sh
wlapse --help
wlapse --version
```

## Colors

To change the colors, create `$XDG_CONFIG_HOME/wlapse/config`. If `XDG_CONFIG_HOME`
is not set, use `$HOME/.config/wlapse/config`.

```ini
background_color = #202229d9
text_color = #ffffff
```

Colors can use `#RRGGBB` or `#RRGGBBAA`. The optional alpha value controls
transparency. Missing settings use the default colors, and lines starting with `#`
are ignored as comments.

Changes take effect the next time the stopwatch starts. An invalid setting is
reported as an error instead of being ignored.

## Moving the stopwatch

Drag the overlay with the left mouse button. `wlapse` saves the new position when
you release the button.

To reset the position, stop `wlapse` and delete:

```text
$XDG_STATE_HOME/wlapse/placement
```

If `XDG_STATE_HOME` is not set, delete:

```text
$HOME/.local/state/wlapse/placement
```

### Lag while dragging in Hyprland

Hyprland may animate the overlay while it is being moved, which makes it lag behind
the pointer. Disable animation for `wlapse` to fix this.

Add this to `hyprland.lua`:

```lua
hl.layer_rule({
    name = "wlapse-no-animation",
    match = { namespace = "^wlapse$" },
    no_anim = true,
})
```

## License

`wlapse` is licensed under the [MIT License](LICENSE).

wlapse

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

wlapse

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README