Skip to content

Releases: Enumber/flipscan

Release list

v1.1.0 — installer picks your camera

v1.1.0 — installer picks your camera Latest
Latest

Choose a tag to compare

View all tags
@Enumber Enumber released this 21 Jul 07:37
v1.1.0
e53a9d9

Flipscan turns a document camera into a hands-free book scanner: point it at a book, flip pages, and it detects each turn, waits for the image to settle, and takes the shot on its own.

New in this release

  • The installer picks your camera. It enumerates the cameras attached to your machine during installation and pins the one you choose, so the first launch already opens the right device instead of whatever happens to be video0. You can still change it any time from the sidebar in the capture window.
    安装时选摄像头：安装过程中列出机器上的摄像头让你选定并写入配置，第一次启动就直接打开正确的设备，不用碰运气。拍照界面侧栏里随时可以改。
  • Interactive installer. Choose where it goes (home directory, a custom path, or system-wide /opt via sudo), and whether you want a desktop icon — pre-marked trusted, so double-clicking launches it with no "Allow Launching?" prompt. Any flag (--system, --prefix, --uninstall, …) keeps it fully non-interactive, exactly as before.
    交互式安装器：选安装位置（用户目录 / 自定义路径 / 系统级 /opt，走 sudo 输密码）、要不要桌面图标（预先标记受信任，双击直接启动）。带参数运行则保持全程非交互。
  • The Chinese README now shows a Chinese screenshot — it previously embedded the English interface.
    中文 README 换上了中文界面截图（之前嵌的是英文图）。

Install

git clone https://github.com/Enumber/flipscan.git
cd flipscan
bash install.sh

Builds a virtualenv with OpenCV and puts a launcher on your desktop and in your application menu.

Full documentation: README · 中文说明

Assets 2
Loading

v1.0.0

v1.0.0

Choose a tag to compare

View all tags
@Enumber Enumber released this 20 Jul 10:36
v1.0.0
c90d415

First public release.

Flipscan turns a document camera into a hands-free book scanner. Point it at a book, flip pages, and it detects each turn, waits for the image to settle, and takes the shot on its own. Captures are cleaned up into readable scans — white background, black text, red stamps preserved.

Install

git clone https://github.com/Enumber/flipscan.git
cd flipscan
bash install.sh

No sudo required. This builds a virtualenv with OpenCV and puts a launcher on your desktop and in your application menu.

Run bash install.sh --help for advanced options (custom install location, system-wide install, menu entry only, uninstall).

Requirements

Python 3.10+, OpenCV and Tk. install.sh handles the Python packages; Tk and v4l-utils come from your distribution — see the README for package names on Debian/Ubuntu, Fedora and Arch.

Cameras

Pick a camera from the control panel and the live view switches over instantly, without restarting. Tick Remember this camera and it is used automatically next time; the choice is stored in ~/.config/flipscan/config.json. If the remembered device is unplugged or renumbered, Flipscan asks you to pick again instead of failing.

Notes

The UI follows your system language (English or Chinese). Chinese documentation: README.zh-CN.md

Gemini-based analysis of captured pages is optional and requires your own API key — see the README.

Licence

GPL-3.0 — see LICENSE. You may use, modify and share this freely, but a
modified version you distribute has to stay open under the GPL as well.

Loading