Skip to content

cherlx/litagent

Repository files navigation

litagent — конвертер FB2 в EPUB для Kindle

Конвертирует FB2 в чистый EPUB3 для Kindle и чинит типографику. Портативное офлайн-приложение для Windows. Convert FB2 to EPUB for Kindle — offline FB2 → EPUB3 converter with typography cleanup.

Сделано на Wails: ядро на Go + интерфейс на Svelte. Без облака, без установки, без регистрации — один .exe.

📷 Скриншот интерфейса будет здесь.


📥 Скачать

Готовый litagent.exe для Windows — на странице релизов:

  1. Скачайте litagent-vX.Y.Z-windows-amd64.zip и распакуйте.
  2. Запустите litagent.exe. Папка wallpaper/ (шаблоны обложек) лежит рядом — ничего настраивать не нужно.
  3. Бинарь не подписан, поэтому Windows SmartScreen может предупредить: нажмите «Подробнее» → «Выполнить в любом случае». Возможны ложные срабатывания антивирусов — это нормально для неподписанных opensource-сборок (исходники открыты, можно собрать самому).

Предпочитаете собрать сами? См. раздел Сборка.


Зачем это нужно

FB2 — основной формат рунета, но Kindle его не читает, а Send to Kindle принимает EPUB. Просто переименовать или сконвертировать «в лоб» мало: FB2-файлы (особенно из сканов и OCR) часто содержат типографский мусор — двойные пробелы, дефисы вместо тире, прямые кавычки, разорванные переносами слова, битую кодировку windows-1251.

litagent приводит текст в порядок и собирает из него аккуратный EPUB3, готовый для Kindle.

Что он делает:

  • Чинит типографику по набору правил — пробелы, тире, кавычки-«ёлочки», многоточия, неразрывные пробелы (предлоги, инициалы, числа), склейку переносов, OCR-артефакты.
  • Конвертирует в качественный EPUB3 — корректная разбивка на главы, рабочая навигация (nav + ncx), всплывающие сноски на Kindle, аккуратный Kindle-safe CSS, обложка.
  • Показывает все правки сгруппированными по правилам — ничего не применяется «вслепую», каждое изменение можно отключить.
  • Генерирует обложки из шаблонов, если в книге её нет.
  • Редактирует метаданные — название, авторы, переводчики, серия, издатель, аннотация.

Правки разделены по уровню уверенности: A (безопасные) и B (эвристические) применяются автоматически, C — только подсказки для ручного ревью. Подробности логики — в DESIGN.md.


❓ FAQ

Как конвертировать FB2 в EPUB для Kindle? Скачайте litagent.exe, откройте FB2 кнопкой «Открыть FB2…», при желании просмотрите правки и метаданные, нажмите «Собрать EPUB…». Получившийся .epub отправьте на Kindle через Send to Kindle (приложение, e-mail или USB).

Чем отличается от Calibre? Calibre — большой комбайн-библиотека. litagent — узкий инструмент под один сценарий «FB2 → хороший EPUB для Kindle» с упором на чистку русской типографики и Kindle-заточку (всплывающие сноски, безопасный CSS). Он портативный (один .exe, без установки) и показывает каждую правку с возможностью отката. См. таблицу ниже.

Работает офлайн? Да, полностью. Ничего не загружается в сеть, файлы не покидают компьютер. Подходит для личной конвертации своих/легальных книг.

Это безопасно? Антивирус/SmartScreen ругается. Бинарь не подписан сертификатом (платная история), поэтому SmartScreen показывает предупреждение, а антивирусы иногда дают ложные срабатывания. Исходный код открыт — при сомнениях соберите .exe сами (см. Сборка).

Поддерживаются ли английские книги и другие форматы (EPUB/TXT/DOCX)? Сейчас вход — FB2, а движок типографики настроен на русский текст. Поддержка английского и других входных форматов — в планах, но пока не реализована.


litagent vs Calibre

litagent Calibre
Фокус FB2 → EPUB для Kindle универсальная библиотека/конвертер
Чистка русской типографики ✅ ядро продукта, правила с диффом ⚠️ базовая, без явного контроля
Kindle-заточка (всплывающие сноски, safe CSS) частично
Видно каждую правку / можно откатить
Установка не нужна, портативный .exe инсталлятор
Офлайн
Форматов на входе FB2 (пока) много

Коротко: нужен один аккуратный EPUB из FB2 под Kindle с чистой типографикой — litagent; нужна библиотека и конвертация десятков форматов — Calibre.


Как пользоваться

  1. Запустите litagent.exe и нажмите «Открыть FB2…».
  2. Книга разбирается, под шапкой появляется сводка (название, автор, язык, число глав, количество найденных правок). Дальше работайте по вкладкам (см. таблицу ниже).
  3. Когда результат устраивает — нажмите «Собрать EPUB…» и выберите, куда сохранить.
Вкладка Что делает
Правки Список всех найденных правок, сгруппированный по правилам, с диффом «было → стало». Слева — правила со счётчиками и галочками: снимите галку у правила A/B, чтобы откатить его, или поставьте у подсказки C, чтобы применить. Клик по названию правила фильтрует список.
Превью Предпросмотр готовой книги в том виде, в каком она попадёт в EPUB.
Обложка Генерация обложки из шаблонов (см. ниже).
Метаданные Редактирование названия, авторов, переводчиков, языка, издателя, серии, даты, ISBN, ключевых слов и аннотации. Изменения применяются при сборке. Кнопка «убрать теги» чистит [мусор] из названия.

Можно открыть другую книгу в любой момент — активная вкладка сразу перезагрузится под неё.

Обложки

Рядом с litagent.exe лежит папка wallpaper — это шаблоны фонов. В комплекте идёт готовый набор шаблонов: при сборке они автоматически копируются рядом с бинарником, так что генерация обложек работает сразу. Список меняется свободно: просто положите или удалите картинки (.jpg, .png, .gif, .webp).

На вкладке «Обложка»:

  • Сгенерировать — берёт случайный фон и рисует по центру верхней половины белую плашку с названием книги и автором (серифный шрифт Georgia). Сразу помечает обложку к сборке.
  • Другой шаблон — выбирает другой случайный фон.
  • Использовать в EPUB — галочка, подставлять ли сгенерированную обложку при сборке.

По умолчанию обложка сохраняет размер и пропорции исходного шаблона — подбирайте картинки под экран вашего Kindle (например 600×800), чтобы не было чёрных полос.

Тонкая настройка (необязательно) — файл wallpaper/cover.json. Поля width/height можно не указывать (берётся размер шаблона) либо задать, чтобы привести все обложки к одному размеру:

{ "jpegQuality": 88,
  "plateWidth": 0.80, "plateCenterY": 0.30,
  "fontTitle": "C:\\Windows\\Fonts\\georgiab.ttf",
  "fontAuthor": "C:\\Windows\\Fonts\\georgia.ttf" }

Папку шаблонов можно переопределить переменной окружения LITAGENT_WALLPAPER.


Сборка

Требуется: Go 1.25+, Node.js 18+, Wails CLI v2. WebView2 на Windows 11 уже встроен; на «чистых» системах его ставит установщик Edge/WebView2 Runtime.

# 1. установить Wails CLI (один раз)
go install github.com/wailsapp/wails/v2/cmd/wails@v2.12.0

# 2. собрать приложение
wails build

Готовый бинарник появится в build/bin/litagent.exe (папка wallpaper/ копируется рядом автоматически). Зависимости фронтенда (npm install) и сборку Svelte Wails выполняет сам.

Разработка с горячей перезагрузкой интерфейса:

wails dev

CLI-режим (конвертация без GUI, удобно для пакетной обработки):

go build -o litagent-cli ./cmd/cli
litagent-cli книга.fb2 [книга.epub]

🇬🇧 In English

litagent — FB2 to EPUB converter for Kindle

litagent turns FB2 e-books into clean EPUB3 files ready for Kindle, and fixes typography along the way. It's a portable, offline desktop app for Windows (Go core + Svelte UI, built with Wails) — no cloud, no install, no signup.

Why: FB2 is the dominant Russian-language e-book format, but Kindle can't read it (Send to Kindle wants EPUB). FB2 files — especially OCR'd ones — carry typographic noise (double spaces, hyphens instead of dashes, straight quotes, broken hyphenation). litagent cleans the text and builds a tidy EPUB3 with working navigation, Kindle pop-up footnotes, a Kindle-safe CSS, and an optional generated cover. Every edit is grouped by rule and can be toggled off — nothing is applied blindly.

Note: input is currently FB2, and the typography engine targets Russian text. English and additional input formats (EPUB/TXT/DOCX) are on the roadmap but not yet implemented.

Download: grab litagent.exe from the Releases page, unzip, and run. The binary is unsigned, so Windows SmartScreen may warn — click "More info" → "Run anyway". Or build it yourself (see Сборка above).


Ключевые слова: конвертер FB2 в EPUB, fb2 to epub, fb2 epub kindle, конвертировать fb2 для kindle, как читать fb2 на kindle, fb2 to epub converter, fb2 epub windows, send to kindle, ebook converter, чистка типографики, fb2 конвертер, fb2 to epub kindle.

⚖️ Инструмент предназначен для личной конвертации своих и легально приобретённых книг.

About

Редактор и конвертер книг FB2 → EPUB3 для Kindle: чистит типографику и собирает аккуратный EPUB. Go + Wails.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors