Skip to content

About

FOLI: a BLE thermal printer with native Android, embedded firmware, custom electronics and a printable enclosure.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

FOLI

Little prints. Everyday joy.

A little thought. Made tangible.

English · 简体中文

Get Android · Get started · Explore the engineering

Android Firmware Documentation

Watch FOLI — Made Tangible

Watch the 90-second film →

FOLI is a complete mini thermal-printer project: battery-powered ESP32 electronics, embedded control, a printable enclosure and a native Android companion. Together, they turn notes, lists and little messages into monochrome paper you can keep close.

A short list beside your keyboard. A few words tucked into a gift. A reminder for the day ahead.

Lifestyle concept visuals, actual CAD geometry, reconstructed app interactions and illustrative paper-feed animation.

One little flow, three places

Create, Templates and Device

Create Templates Device
Shape your words, choose a paper style and inspect the monochrome preview Start with eight templates, filter, save and make one yours Discover the printer, inspect reported state and find printing help

No account is required. Editing and preview work offline; physical printing needs matching hardware. The tour combines actual captures with interaction visualization; Device is reconstructed from current source in the disconnected state.

Download 0.2.1 development APK · Android source and build guide

From the screen to the paper

Software-to-paper system architecture

The Android renderer turns a layout into a 384-dot monochrome raster. Each row occupies 48 bytes. BLE carries row data to firmware that coordinates the thermal head and paper feed. The enclosure brings the battery, board, roll and mechanism together.

Annotated CAD assembly

Architecture and protocol · Hardware · Mechanical and assembly · Firmware

Decisions behind the experience

  • Preview the raster that will be sent. Preview and transmission share the encoder, so the paper view reflects monochrome output.
  • Design for an older phone. Xiaomi Mi 6 checks informed keyboard layout, editor controls and explicit checklist rendering.
  • Separate connection, transfer and completion. Interrupted or unconfirmed jobs use conservative recovery. Firmware hardening addresses command framing and fault shutdown paths.

Read the engineering case study · Verification and known limits

Built, wired, on paper

Historical hardware and print-test photographs

Physical hardware has been assembled and previously print-tested. Android 0.2.0 was inspected on Xiaomi Mi 6 for UI and BLE state. Version 0.2.1 adds BLE exception recovery with software checks. The hardened firmware and new app have not been revalidated together in a fresh physical print.

Explore the build

Your next step Start here
Try the app without a printer Installation and usage
Build Android JDK, SDK and build commands
Build and flash firmware PlatformIO project
Inspect or manufacture the board Final project, BOM and exports
Make the enclosure STLs, source mapping and assembly
Reuse the product media Provenance and rebuild guide

Open development

This repository retains the Mini-Printer history and integrates the FOLI Android app, product design, mechanical assets, presentation media and reliability work. Sources and contributions distinguish the inherited platform from new implementation.

Roadmap · Contributing · Versions and downloads · License · Third-party and media notices

About

FOLI: a BLE thermal printer with native Android, embedded firmware, custom electronics and a printable enclosure.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages