hibiki - GitLite

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #rust #deep-learning #java #awesome #kubernetes #awesome-list #pytorch #mcp #open-source

hibiki

(★ 115)

Elevating the tactile dialogue. A high-fidelity visual and auditory companion that gives your keystrokes a modern resonance.

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yml
- hibiki.desktop
- hibiki.svg
- showcase.gif
- showcase.mp4
- font_loading.rs
- package.nix
- shell.nix
- - audio_dispatcher.rs
  - config_service.rs
  - feedback_service.rs
  - mod.rs
  - routing.rs
  - typography_service.rs
- - logo-symbolic.svg
- - hyprland.rs
  - mod.rs
  - niri.rs
  - sway.rs
- - audio.rs
  - commands.rs
  - config.rs
  - events.rs
  - mod.rs
  - state.rs
- - audio.rs
  - audio_test.rs
  - font_provider.rs
  - hotkey.rs
  - mod.rs
  - settings_repository.rs
- - device.rs
  - keymap.rs
  - layout.rs
  - listener.rs
  - mod.rs
  - xkb.rs
- - mod.rs
  - overlay_manager.rs
- - bubble.rs
  - display.rs
  - drag.rs
  - icon_renderer.rs
  - launcher.rs
  - mod.rs
  - settings.rs
  - window.rs
- app.rs
- lib.rs
- main.rs
- tray.rs
- bubble.css
- defaults.css
- launcher.css
- osd.css
- overlay.css
- settings.css
- config_migration.rs
- settings_logic.rs
.envrc
.gitignore
Cargo.lock
Cargo.toml
flake.lock
flake.nix
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/linuxmobile/hibiki

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd hibiki

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Rust (rustup) cargo 명령어를 쓰려면 Rust가 필요합니다.

cargo install --path .

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Rust

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

cargo install --path .

이 명령어를 터미널에 그대로 입력해 실행하세요.

cargo run --release

빌드 후 바로 실행까지 진행합니다.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 響 (Hibiki)

![Hibiki Demo](https://raw.githubusercontent.com/linuxmobile/hibiki/main/assets/showcase.gif)

A GTK4 Layer Shell keystroke visualizer for Wayland compositors, built specifically for Wayland. While tools like showmethekey exist, I've always felt they lacked a bit of that "modern" aesthetic. So, heavily inspired by the look of [KeyCastr](https://github.com/keycastr/keycastr), I decided to build my own version.

And yes, it's written in Rust, so you already know it's blazing fast and memory-safe.

## Key Features

- **Wayland Native**: No more X11 workarounds; built to work with modern compositors.
- **Two Display Modes**:
  - **Keystroke**: The classic view for showing exactly what you're hitting.
  - **Bubble**: A sleek, minimal style inspired by [devaslife's setup](https://www.youtube.com/watch?v=zu_vqAWHy_E).
- **Native Audio Engine**:
  - Built-in `rodio`-based audio engine on a dedicated thread.
  - Compatible with **Mechvibes** sound packs (single and multi-file support).
  - Zero-copy sample playback for low latency.
- **Modern Configuration**:
  - Configuration migrated to `config.toml` (auto-migrates from old JSON).
  - **Granular Typography**: Customize font family, weight, and size per mode.
  - **Virtualization**: Optimized Settings UI handles large lists of fonts and sound packs with zero lag.
- **System Integration**:
  - **GTK Theme Support**: Automatically respects your system theme.
  - **System Tray**: Quick access to toggle modes, pause capture, or open settings.
  - **Draggable**: Visualizer windows can be repositioned easily.

## Supported Compositors

Hibiki attempts to automatically detect your running compositor.

| Compositor    | Support Level           | Notes                                                  |
| ------------- | ----------------------- | ------------------------------------------------------ |
| **Niri**      | 🟢 **Tested & Working** | Fully supported layout detection and event handling.   |
| **Hyprland**  | 🟡 **Experimental**     | Implemented but needs community testing.               |
| **Sway**      | 🟡 **Experimental**     | Implemented but needs community testing.               |
| **River/DWL** | 🔴 **Basic/None**       | Layout detection may fail; "Basic support" is minimal. |

> **Note**: Real compositor support is complex! I can't detect layouts reliably on all compositors without specific implementations. **I need help testing Hyprland and Sway!** If you use these, please report issues.

## Installation

### Prerequisites

You need a Wayland compositor and the following system libraries:

- `libgtk-4-dev`
- `libgtk4-layer-shell-dev`
- `libasound2-dev` (for audio)

### Via Cargo

If you have Rust installed:

```bash
cargo install --path .
# or
cargo run --release
```

### Via Nix

Flake support is included!

```bash
# Run directly
nix run github:linuxmobile/hibiki

# Build
nix build github:linuxmobile/hibiki

# Develop
nix develop
```

## Contributing & Help Needed

The project is currently in **Early WIP**.

### 🛑 We Need Your Help!

1.  **Compositor Testing**: We specifically need testers for **Hyprland** and **Sway**. The code is there, but I only use Niri.
2.  **Packaging**: We need maintainers for **AUR**, **Debian/Ubuntu**, **Fedora**, etc.
3.  **Feedback**: Found a bug? Open an issue!

### Development

1.  Clone the repo.
2.  Run `cargo run` to start dev mode.
3.  Check `src/compositor` to understand how we handle different Wayland protocols.

---

If you find this useful, I'd really appreciate it if you could:

- ⭐ Drop a star on the repo!
- 💡 Open an Issue with ideas.
- 🛠️ Submit a PR.