1
0
mirror of https://github.com/sashacmc/photo-importer.git synced 2024-11-24 08:02:14 +02:00
photo-importer/README.md
2022-01-30 02:10:43 +01:00

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!**