mirror of
https://github.com/sashacmc/photo-importer.git
synced 2024-11-24 08:02:14 +02:00
86 lines
2.8 KiB
Markdown
86 lines
2.8 KiB
Markdown
# Photo Importer
|
|
|
|
[![Total alerts](https://img.shields.io/lgtm/alerts/g/sashacmc/photo-importer.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/sashacmc/photo-importer/alerts/)
|
|
[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/sashacmc/photo-importer.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/sashacmc/photo-importer/context:javascript)
|
|
[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/sashacmc/photo-importer.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/sashacmc/photo-importer/context:python)
|
|
|
|
Command line tools for photo importing/renaming/rotating
|
|
### Features:
|
|
* Media files scan
|
|
* Time when picture was taken detection (by EXIF, by file name, by file attributes)
|
|
* Media files moving/copying to configurable hierarchy
|
|
* Lossless rotations (via exiftran)
|
|
|
|
# Photo Importer Server
|
|
Standalone web server for fast media import for headless computer
|
|
### Features:
|
|
* Mounted storages detection (by path mask)
|
|
* Storages mount/unmount (via pmount)
|
|
* The same as photo-importer but without console
|
|
|
|
## Installation
|
|
|
|
### Requirements:
|
|
|
|
* Python 3.3+
|
|
* Debian based Linux (Other Linux versions not officially supported, but might work)
|
|
|
|
### Dependencies:
|
|
* PyExifTool (pip3 install PyExifTool)
|
|
* python3-progressbar
|
|
* python3-psutil
|
|
* exiftran or jpegtran
|
|
* pmount (only for server)
|
|
|
|
|
|
### Installation Options:
|
|
|
|
#### Installing as debian package
|
|
```bash
|
|
debuild -b
|
|
sudo dpkg -i ../photo-importer_1.0.1_all.deb
|
|
```
|
|
#### Installing via setup.py
|
|
```bash
|
|
sudo python3 ./setup.py install
|
|
```
|
|
|
|
## Usage
|
|
### Command-Line Interface
|
|
|
|
```bash
|
|
photo-importer /path/to/media/files
|
|
```
|
|
Will process files (reanaming/rotating) in-place.
|
|
![In place example](https://user-images.githubusercontent.com/28735879/76139947-bd249780-6055-11ea-85c0-0985b6bde93f.png)
|
|
|
|
```bash
|
|
photo-importer /path/to/media/files /output/path
|
|
```
|
|
Will import (by default move, but it can be changed in config) files from /path/to/media/files to /output/path with date hierarchy creation and reanaming/rotating
|
|
|
|
![Move example](https://user-images.githubusercontent.com/28735879/76139964-eba27280-6055-11ea-988f-aa71cda7ba36.png)
|
|
|
|
### Web Interface
|
|
* attach usb-drive / usert memory card
|
|
* open http://servername:8080
|
|
* click "Mount"
|
|
* click "Import"
|
|
* click "Unmount"
|
|
|
|
![Web interface example](https://user-images.githubusercontent.com/28735879/76140174-f1995300-6057-11ea-8718-19c38650c786.png)
|
|
|
|
## Configuration
|
|
The server config file located in /etc/photo-importer.cfg
|
|
|
|
Command line tool config file located in ~/.photo-importer.cfg
|
|
|
|
Also config file can be specified by mean of -c command line option.
|
|
|
|
For options details see comments in the config file.
|
|
|
|
## Acknowledgements
|
|
Thanks to everyone who tested and gave advice.
|
|
|
|
**Bug reports, suggestions and pull request are welcome!**
|