🚀 LitOrganizer v2.0.0 — AI-Powered Web Application
Major Release: LitOrganizer has been completely redesigned from a PyQt5 desktop application to a modern Flask + Socket.IO web application with Google Gemini AI integration.
✨ Highlights
- 🤖 Google Gemini AI Integration — AI-powered metadata extraction when DOI lookup fails
- 🌐 Modern Web Interface — Clean, responsive UI with Tailwind CSS
- ⚡ Real-time Updates — WebSocket-powered live progress with animated progress rings
- 📁 Native OS Folder Picker — Select directories using your system's file dialog
- 📚 Published in SoftwareX (Elsevier) — DOI: 10.1016/j.softx.2025.102198
➕ Added
- Google Gemini AI Integration: AI-powered metadata extraction using Gemini Flash 2.0 as an intelligent fallback when DOI extraction fails
- Inline Gemini AI Panel: Real-time results panel showing connection status, active queries, and extracted metadata
- Separate AI Folder Option: Place Gemini AI-named files in
AI Named Content/instead of defaultNamed Article/ - Modern Web Interface: Clean, responsive UI built with Tailwind CSS
- Real-time WebSocket Updates: Live progress tracking with circular progress rings
- Native OS Folder Picker: System-level folder picker with quick access shortcuts
- DOI Fallback Pipeline: Multi-stage extraction: DOI → Gemini AI → Crossref validation
- Global Activity Panel: Persistent bottom panel with progress indicators across all pages
- Completion Modal: Summary after processing with "Open Folder" and "View Statistics" buttons
- Usage Guide Page: Comprehensive documentation with pipeline flowchart and API reference
- Search Export Modal: Export results to Word/Excel with highlighted matches
🔧 Fixed
- Backup System: Files are now properly backed up before renaming
- Open Folder Button: Cross-platform folder opening now works correctly
- Statistics Persistence: Processing stats survive page navigation
- Real-time Counter Updates: Live statistics during PDF processing
- Startup Scripts: Improved reliability and error handling for Windows/macOS/Linux launchers
🔄 Changed
- Architecture: Complete migration from PyQt5 desktop GUI to Flask + Socket.IO web app
- Python Requirement: Now supports Python 3.10+ (previously 3.11 only)
- Launcher Scripts: Modernized with better dependency management
❌ Removed
- PyQt5 Desktop GUI: Legacy desktop interface completely removed
- Drag & Drop: Replaced with native OS folder picker
- Heuristic Extraction: Replaced by Google Gemini AI
📥 Installation
Quick Start (Recommended)
- Download and extract LitOrganizer-v2.0.0.zip (Windows) or LitOrganizer-v2.0.0.tar.gz (macOS/Linux)
- Run the launcher script:
- Windows: Double-click start_litorganizer.bat
- macOS: Double-click
Start LitOrganizer.commandor run ./start_litorganizer.sh - Linux: Run ./start_litorganizer.sh
- Open
http://localhost:5000in your browser
Requirements
- Python 3.10 or higher
- Internet connection (for API metadata retrieval)
📖 Documentation
See the User Guide for detailed instructions on:
- Naming pipeline and confidence levels
- Gemini AI setup and configuration
- Keyword search with regex examples
- API reference and configuration
📚 Citation
If you use LitOrganizer in your research, please cite:
Şahin, A., Kara, B. C., & Dirsehan, T. (2025). LitOrganizer: Automating the process of data extraction and organization for scientific literature reviews. SoftwareX, 30, 102198. https://doi.org/10.1016/j.softx.2025.102198