v1.0.0

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.