Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stsewd/bookpy
Renames your e-books for better organization.
https://github.com/stsewd/bookpy
books ebooks isbn rename tool
Last synced: 4 months ago
JSON representation
Renames your e-books for better organization.
- Host: GitHub
- URL: https://github.com/stsewd/bookpy
- Owner: stsewd
- License: mit
- Created: 2016-08-07T00:20:11.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-10-29T01:25:44.000Z (over 8 years ago)
- Last Synced: 2024-10-04T18:43:19.965Z (4 months ago)
- Topics: books, ebooks, isbn, rename, tool
- Language: Python
- Size: 467 KB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bookpy
[](https://badge.fury.io/py/bookpy)
Renames your e-books for better organization.
# Supported Files
For now only pdf files.
# Dependencies
## Python Packages
- isbnlib
- isbntools
- click
## Extra Dependencies
- [pdftotext](https://en.wikipedia.org/wiki/Pdftotext)
# Basic Usage
```
bookpy [OPTIONS] [SRCS]...
SRCS are the books sources (individual files or a directory).
If no source is given, the current directory will be taken.
Options:
--version Show the version and exit.
-r, --recursive Get all files recursively from a directory.
-t, --template Specify a template with which the books are renamed.
Default template is '{short_title} - {main_author} ({year})'
-h, --help Show the help and exit.
```
# Example
## Before
```
books/
├── 97.things.every.programmer.should.know.pdf
├── Algorithms.pdf
├── clean_code.pdf
├── intro algorithms.pdf
├── os - andrew tanenbaum.pdf
├── Refactoring.pdf
├── SoftSkills.pdf
└── the_pragmatic_programmer_Andrew_Hunt.pdf
```
## Command
```
bookpy books/
```
## After
```
books/
├── 97 Things Every Programmer Should Know - Kevlin Henney (2010).pdf
├── Algorithms - Robert Sedgewick.pdf
├── Clean code - Robert C. Martin.pdf
├── Introduction To Algorithms - Thomas H. Cormen (2009).pdf
├── Operating Systems - Andrew S. Tanenbaum (2014).pdf
├── Refactoring - Martin Fowler (1999).pdf
├── Soft Skills - John Z. Sonmez (2014).pdf
└── The pragmatic programmer - Andrew Hunt.pdf
```
# Installation
## Using pip
`pip3 install bookpy`
## Manual Installation
`git clone https://github.com/stsewd/bookpy`
`cd bookpy`
`pip3 install -r requirements.txt`
`pip3 install .`
# Coming Soon
- Rename a file given a specific ISBN.
- Threads.
- Specify_a_separator_between_words.
- Full template support (templates for each element (autors, title, etc.)).
- Specify text case.
- Support for epub files.
- Intensive search.