Changelog - marinov752/emailtokoreader.koplugin GitHub Wiki

Changelog

All notable changes to Email to KOReader will be documented in this file.

[1.1.1] – 2025-11-15

Fixes

  • Added version field to manifest.lua for KOReader Updates Manager compatibility
  • Improved fallback path logic with a cleaner preference chain
  • Fixed crash in Settings dialog caused by calling MultiInputDialog:getFields() on the class instead of the instance (settings_dialog:getFields() is now used)
  • Fixed issue where settings sometimes failed to save due to incorrect field retrieval
  • Improved reliability of download path validation with clearer debug logs
  • General stability improvements for saving configuration and writing files

Improvements

  • Removed unnecessary pcall() wrappers for modules that are always available in KOReader
  • Cleaner and more consistent fallback path assignment
  • Improved settings persistence code
  • Minor code cleanup, formatting fixes, and internal optimizations

[1.1.0] – 2025-11-03

New

  • Cyrillic and Unicode filename support (RFC 2047 / 2231 decoding)
  • Automatic Cyrillic→Latin transliteration for filename compatibility
  • Smart fallback path system (user home → KOReader home directory)
  • Added "View Download Path" menu item

Fixes

  • Improved write error handling with detailed messages
  • Automatic directory creation when missing
  • Improved path validation logic

Improvements

  • Multi-line email header support
  • More informative logging
  • Better user notifications

[1.0.0] – 2025-11-02

Initial Release

First stable release of Email to KOReader plugin.

Added

  • IMAP email integration for automatic EPUB downloads
  • Support for multiple EPUB attachments
  • Support for processing multiple emails in one fetch
  • Large file support (up to 3.5MB)
  • Streaming parser for memory-efficient processing
  • In-app configuration dialog
  • Settings editor with masked password field
  • Test connection functionality
  • Auto-refresh file browser
  • Debug mode with detailed logging
  • Duplicate file detection
  • Message boundary detection
  • Gmail App Password support
  • SSL/TLS support
  • Base64 decoding
  • Chunked file writing
  • Garbage collection after large operations

Configuration

  • Email address
  • App password
  • IMAP server
  • IMAP port
  • Download path
  • Debug mode toggle
  • SSL/TLS toggle

Limitations

  • Max file size: 3.5MB
  • File type: EPUB only
  • Max 3 unread emails processed per check
  • IMAP only

Technical Details

  • Language: Lua
  • Dependencies: LuaSocket (included in KOReader)
  • Uses streaming memory model
  • Credentials stored locally only

Documentation

  • README.md
  • LICENSE (MIT)
  • Example configuration file

Known Issues

  • None at initial release

Version Format

Semantic Versioning: MAJOR.MINOR.PATCH

  • MAJOR: Breaking changes
  • MINOR: New features
  • PATCH: Bug fixes