Futon

README

Futon

Một terminal manga reader nhanh, gọn nhẹ viết bằng Go.

Futon render ảnh manga trực tiếp trong terminal của bạn qua Kitty Graphics Protocol hoặc Sixel — không cần phần mềm xem ảnh rời. Tìm kiếm truyện từ nhiều nguồn, duyệt chapter, và đọc với phím tắt kiểu Vim.

Tính năng nổi bật

• Render ảnh trong terminal — Kitty Graphics Protocol hoặc Sixel
• Đa nguồn truyện — MangaDex, OTruyen (chuyển bằng tab) (sắp có thêm)
• Favorites & Lịch sử đọc — đánh dấu truyện yêu thích, đọc tiếp từ trang đã dừng
• Tải ảnh — lưu trang bằng ctrl+d
• Preload chapter kế tiếp — chuyển chapter mượt mà, không chờ load
• LRU image cache — lật trang nhanh như chớp
• Jump nhanh — gõ số chapter rồi enter
• Lọc ngôn ngữ — /lang vi hoặc /lang en cho MangaDex
• Phím tắt kiểu Vim — phím mũi tên, nhảy số

Yêu cầu

Terminal hỗ trợ Kitty Graphics Protocol hoặc Sixel:

Terminal	Protocol
Kitty	Kitty (native)
WezTerm	Kitty + Sixel
Ghostty	Kitty + Sixel
foot	Sixel
iTerm2	Sixel
Konsole	Sixel
mlterm	Sixel
XTerm	Sixel (compile với --enable-sixel)

Lưu ý: Kitty graphics nhanh và mượt hơn Sixel trên cùng một terminal. Nếu terminal bạn hỗ trợ cả hai, Futon sẽ ưu tiên dùng Kitty.

Hướng dẫn Cài đặt

Tự động (khuyên dùng)

curl -sSL https://raw.githubusercontent.com/KabosuNeko/Futon/main/install.sh | bash

Script sẽ tự động phát hiện OS và architecture, tải bản release mới nhất từ GitHub Releases về và cài vào /usr/local/bin/.

Để gỡ cài đặt:

curl -sSL https://raw.githubusercontent.com/KabosuNeko/Futon/main/install.sh | bash -s -- uninstall

Build từ source

go install github.com/KabosuNeko/Futon@latest

Binary

Tải bản mới nhất từ Releases.

Hỗ trợ:

• Linux (amd64, arm64)
• macOS (amd64, arm64)

Cách dùng

futon

Hệ thống Phím tắt

Màn hình tìm kiếm

Phím	Chức năng
ctrl+c	Thoát
tab	Chuyển nguồn manga
enter	Tìm kiếm / mở truyện đang chọn
lên / xuống	Di chuyển danh sách
/fav	Xem danh sách yêu thích
/his	Xem lịch sử đọc
/lang vi|en	Chọn ngôn ngữ chapter (MangaDex)

Favorites / Lịch sử

Phím	Chức năng
enter	Mở truyện
ctrl+d	Xoá khỏi danh sách
esc	Quay lại tìm kiếm

Danh sách chapter

Phím	Chức năng
lên / xuống	Duyệt chapter
ctrl+f	Thêm/xoá yêu thích
enter	Mở chapter
[số] + enter	Nhảy tới chapter
esc	Quay lại tìm kiếm
ctrl+c	Thoát

Reader

Phím	Chức năng
→ / l	Trang tiếp
← / h	Trang trước
ctrl+d	Tải trang hiện tại
esc	Về danh sách chapter
ctrl+c	Thoát

Dữ liệu

Dữ liệu	Đường dẫn
Favorites	~/.config/futon/favorites.json
Lịch sử đọc	~/.config/futon/history.json
Ảnh đã tải	~/Downloads/Futon_Downloads/

Kiến trúc

cmd/main.go          — entry point
internal/
  api/               — MangaProvider interface & HTTP clients
  models/            — shared data types
  storage/           — JSON persistence (favorites, history)
  tui/               — Bubble Tea screens (search, chapters, reader)
  tui/imgrender/     — Kitty / Sixel renderer selection

Giấy phép

MIT