Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dnkorpushov/libro2
Tools for fb2 and epub files
https://github.com/dnkorpushov/libro2
epub fb2 gui metadata pyqt5 python python3
Last synced: about 2 months ago
JSON representation
Tools for fb2 and epub files
- Host: GitHub
- URL: https://github.com/dnkorpushov/libro2
- Owner: dnkorpushov
- License: gpl-3.0
- Created: 2022-06-03T13:47:27.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-01-17T15:20:43.000Z (about 2 years ago)
- Last Synced: 2023-03-04T22:28:40.977Z (almost 2 years ago)
- Topics: epub, fb2, gui, metadata, pyqt5, python, python3
- Language: Python
- Homepage:
- Size: 1020 KB
- Stars: 15
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
#  Libro2
GUI tool for organizing fb2 and epub files.
Key features:
* сhange metadata such as title, author, series, cover, and more
* convert fb2 files to epub, kepub, mobi and awz3. For this feature need [fb2converter](https://github.com/rupor-github/fb2converter)
* rename files by template based on metadata
* support extension plugins
* program runs under Microsoft Windows (10 and above), MacOS (10.14.6 Mojave and above) and Linux.
[User manual (in Russian)](https://github.com/dnkorpushov/libro2/wiki).
## Build Libro2
Requirements: git, python3.9 and above, python modules: pyqt5 (5.12 and above), lxml, pyinstaller, ebookmeta, darkdetect.
Install python and required modules.
Download Libro2:
```
git clone https://github.com/dnkorpushov/libro2.git
cd libro2
```
### For Windows and MacOS
Build executables:
```
python3 build.py freeze
```
Check dist folder for executables.
Build installer (optional):
```
python3 build.py installer
```
Check intsaller folder for installer. libro2.win32.installer.exe for Windows, libro2.macos.dmg for MacOS.
### For Linux
For Linux run Libro2 from source:
```
./libro2.sh
```
Add libro2 in Application menu for Gnome3 and etc. (optional):
```
python3 build.py install
```
Check Application menu. Tests for Ubuntu 22.04. May not work for other linux distros.
## build.py
Build.py is a script for support libro2 development.
Usage:
```
python3 build.py [command]
```
List of commands:
* run - run project
* ui - compile qt ui forms after change it in qt designer.
* rc - compile rc resorces after change it in qt designer.
* locale - make and compile locale resources. Run command before translating for collect strings for translate. Use qt linguist for translating strings. Run command after translating for compile locale resource files.
* freeze - build executables.
* installer - build installer. Run after freeze command. Use for Windows and MacOS.
* install - add Libro2 icon in Application menu for Linux DE (Gnome3 and etc.)
* clean - clean project (delete unnecessary folder and files, such as build, dist folder and etc.)