docs: Flatpak-only install in README, update CHANGELOG
- README: keep only Flatpak install/build instructions, remove everything else - CHANGELOG: add Flatpak packaging entry to v0.1.4
This commit is contained in:
parent
1aa109f5bf
commit
769d84aa80
2 changed files with 25 additions and 85 deletions
11
CHANGELOG.md
11
CHANGELOG.md
|
|
@ -1,6 +1,15 @@
|
||||||
# Changelog
|
# Changelog
|
||||||
|
|
||||||
## v0.1.4 (2026-06-26)
|
## v0.1.4 (2026-06-28)
|
||||||
|
|
||||||
|
### Flatpak Packaging
|
||||||
|
- **Flatpak bundle** with all components: daemon, CLI, system tray, uinputd, XRecord, wrapper script
|
||||||
|
- **System tray icon** via D-Bus StatusNotifierItem (ksni)
|
||||||
|
- **Build script** `packaging/flatpak/build-flatpak.sh` — automated build from source
|
||||||
|
- **Permissions:** X11, Wayland, D-Bus session bus, input devices, IPC
|
||||||
|
|
||||||
|
### Documentation
|
||||||
|
- README updated with Flatpak-only install/build instructions
|
||||||
|
|
||||||
### Clipboard & Injection
|
### Clipboard & Injection
|
||||||
- **Fix clipboard-into-text race** — Eliminated race condition where clipboard content leaked into typed text during Unicode injection.
|
- **Fix clipboard-into-text race** — Eliminated race condition where clipboard content leaked into typed text during Unicode injection.
|
||||||
|
|
|
||||||
99
README.md
99
README.md
|
|
@ -265,65 +265,25 @@ Flexible typing: type the full syllable, then add marks/tone keys at the end. Ex
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
> **Safety:** Viet+ is a pure Rust project. Building from source with `cargo` never touches
|
### Flatpak (recommended)
|
||||||
> your system's `libc` or other core libraries — everything is compiled locally in `target/`.
|
|
||||||
> No `sudo` is needed for building. Only the optional system-wide install requires root.
|
```bash
|
||||||
|
# Download from the release page, then:
|
||||||
### Quick Start (run without installing)
|
flatpak install --user --bundle VietPlus-x86_64.flatpak
|
||||||
|
flatpak run io.github.vietc.VietPlus
|
||||||
|
```
|
||||||
|
|
||||||
|
Includes daemon + CLI + system tray + uinput daemon. Sandboxed — no system libraries are touched.
|
||||||
|
|
||||||
|
### Build from Source (Flatpak)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Install Rust if needed: https://rustup.rs
|
|
||||||
git clone https://github.com/vndangkhoa/vietc.git
|
git clone https://github.com/vndangkhoa/vietc.git
|
||||||
cd vietc
|
cd vietc/packaging/flatpak
|
||||||
|
bash build-flatpak.sh
|
||||||
# Build everything (daemon + CLI)
|
|
||||||
cargo build --release --features "x11,wayland"
|
|
||||||
|
|
||||||
# Run the daemon directly (no install)
|
|
||||||
sudo ./target/release/vietc
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Full Install (system-wide)
|
Requires Flatpak runtime `org.gnome.Platform//50` and Rust SDK extension (installed automatically).
|
||||||
|
|
||||||
```bash
|
|
||||||
# 1. Build the daemon and CLI
|
|
||||||
cargo build --release --features "x11,wayland"
|
|
||||||
|
|
||||||
# 2. Build the system tray (optional)
|
|
||||||
cd ui && cargo build --release && cd ..
|
|
||||||
|
|
||||||
# 3. Install binaries
|
|
||||||
sudo cp target/release/vietc /usr/local/bin/
|
|
||||||
sudo cp target/release/vietc-cli /usr/local/bin/
|
|
||||||
sudo cp target/release/vietc-uinputd /usr/local/bin/
|
|
||||||
sudo cp ui/target/release/vietc-tray /usr/local/bin/ 2>/dev/null || true
|
|
||||||
|
|
||||||
# 4. Compile X11 capture helper
|
|
||||||
gcc -O2 -o /usr/local/bin/vietc-xrecord packaging/appimage/vietc-xrecord.c -lX11 -lXtst
|
|
||||||
|
|
||||||
# 5. Install config
|
|
||||||
mkdir -p ~/.config/vietc
|
|
||||||
cp vietc.toml ~/.config/vietc/config.toml
|
|
||||||
|
|
||||||
# 6. Start the daemon
|
|
||||||
sudo vietc
|
|
||||||
```
|
|
||||||
|
|
||||||
### AppImage (portable)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./Viet+-0.1.0-x86_64.AppImage
|
|
||||||
```
|
|
||||||
|
|
||||||
Includes daemon + tray + CLI + xclip. Self-contained — no system libraries are modified.
|
|
||||||
|
|
||||||
### Debian/Ubuntu
|
|
||||||
|
|
||||||
```bash
|
|
||||||
sudo dpkg -i vietc_0.1.0-1_amd64.deb
|
|
||||||
```
|
|
||||||
|
|
||||||
Requires: `libxtst6`
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -335,7 +295,7 @@ Config file: `~/.config/vietc/config.toml` or `./vietc.toml`
|
||||||
input_method = "vni" # "vni" or "telex"
|
input_method = "vni" # "vni" or "telex"
|
||||||
toggle_key = "space" # Ctrl+Space to toggle
|
toggle_key = "space" # Ctrl+Space to toggle
|
||||||
start_enabled = false # English by default
|
start_enabled = false # English by default
|
||||||
grab = true # grab keyboard (AppImage)
|
grab = true # grab keyboard (evdev)
|
||||||
|
|
||||||
[auto_restore]
|
[auto_restore]
|
||||||
enabled = true
|
enabled = true
|
||||||
|
|
@ -355,35 +315,6 @@ lm = "làm"
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Building from Source
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Build with all backends (X11 + Wayland)
|
|
||||||
cargo build --release --features "x11,wayland"
|
|
||||||
|
|
||||||
# Build only X11
|
|
||||||
cargo build --release --features x11
|
|
||||||
|
|
||||||
# Build only Wayland
|
|
||||||
cargo build --release --features wayland
|
|
||||||
|
|
||||||
# Build system tray (needs libdbus-1-dev on Debian/Ubuntu)
|
|
||||||
cd ui && cargo build --release
|
|
||||||
|
|
||||||
# Run tests
|
|
||||||
cargo test
|
|
||||||
|
|
||||||
# Build packages
|
|
||||||
make deb # .deb package
|
|
||||||
make appimage # AppImage (requires appimagetool)
|
|
||||||
make flatpak # Flatpak
|
|
||||||
```
|
|
||||||
|
|
||||||
> **Note:** All builds are confined to `target/` — no system files are touched until
|
|
||||||
> you explicitly run `sudo make install` or `sudo cp`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
MIT License — see [LICENSE](LICENSE) for details.
|
MIT License — see [LICENSE](LICENSE) for details.
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue