{"id":15051202,"url":"https://github.com/sashacmc/photo-importer","last_synced_at":"2025-04-10T02:41:12.737Z","repository":{"id":44694057,"uuid":"132265926","full_name":"sashacmc/photo-importer","owner":"sashacmc","description":"Command line and web tools for photo importing/renaming/rotating","archived":false,"fork":false,"pushed_at":"2024-05-22T21:27:58.000Z","size":129,"stargazers_count":40,"open_issues_count":0,"forks_count":8,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-05-22T21:33:17.752Z","etag":null,"topics":["debian","photo","photo-manager","python3","tools","video"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sashacmc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-05T16:36:37.000Z","updated_at":"2024-07-09T00:20:22.720Z","dependencies_parsed_at":"2024-07-09T00:30:18.163Z","dependency_job_id":null,"html_url":"https://github.com/sashacmc/photo-importer","commit_stats":{"total_commits":93,"total_committers":4,"mean_commits":23.25,"dds":"0.29032258064516125","last_synced_commit":"b2aedc4be49d8659350b2076dbb9a5b5de83b332"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sashacmc%2Fphoto-importer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sashacmc%2Fphoto-importer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sashacmc%2Fphoto-importer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sashacmc%2Fphoto-importer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sashacmc","download_url":"https://codeload.github.com/sashacmc/photo-importer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248144911,"owners_count":21055008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["debian","photo","photo-manager","python3","tools","video"],"created_at":"2024-09-24T21:31:40.757Z","updated_at":"2025-04-10T02:41:12.718Z","avatar_url":"https://github.com/sashacmc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Photo Importer\n\n![CodeQL](https://github.com/sashacmc/photo-importer/workflows/CodeQL/badge.svg)\n[![PyPI - Version](https://img.shields.io/pypi/v/photo-importer.svg)](https://pypi.org/project/photo-importer)\n[![PyPI - Downloads](https://pepy.tech/badge/photo-importer)](https://pepy.tech/project/photo-importer)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\nCommand line tools for photo importing/renaming/rotating\n### Features:\n  * Media files scan\n  * Time when picture was taken detection (by EXIF, by file name, by file attributes)\n  * Media files moving/copying to configurable hierarchy \n  * Lossless rotations (via exiftran or jpegtran)\n\n# Photo Importer Server\nStandalone web server for fast media import for headless computer\n### Features:\n  * Mounted storages detection (by path mask)\n  * Storages mount/unmount (via pmount)\n  * The same as photo-importer but without console\n\n# Installation\n\n### Requirements:\n\n  * Python 3.3+\n\n### Supported OS:\n\n  * Debian based Linux (other Linux versions not officially supported, but might work)\n  * Windows 7 and above\n  * MacOS X and above (with brew installed, only console version)\n\n### Dependencies:\n  * [PyExifTool](https://pypi.org/project/PyExifTool/)\n  * [progressbar](https://pypi.org/project/progressbar/)\n  * [psutil](https://pypi.org/project/psutil/)\n  * [exiftran](https://linux.die.net/man/1/exiftran) or [jpegtran](https://linux.die.net/man/1/jpegtran)\n  * [pmount](https://linux.die.net/man/1/pmount) (only for server)\n  * [pypiwin32](https://pypi.org/project/pypiwin32/) (only for windows)\n\n\n### Installation Options:\n\n#### Installing via PyPi\n```bash\nsudo apt install exiftran exiftool pmount pip\nsudo pip install photo-importer\n```\n#### Installing as debian package\n```bash\ndebuild -b\nsudo apt install pip python3-exif python3-progressbar exiftran python3-psutil\nsudo pip install PyExifTool\nsudo dpkg -i ../photo-importer_1.2.5_all.deb\n```\n#### Installing via setup.py\n```bash\nsudo apt install exiftran exiftool pmount pip\nsudo pip install PyExifTool progressbar psutil\nsudo python3 ./setup.py install\n```\n\n#### Installing for Windows\nDownload and install python3 for you Windows distributive\nhttps://www.python.org/downloads/windows/\n\nDownload and install exiftool\nhttps://exiftool.org/\n\nDownload and extract jpegtran to photo_importer folder\nhttp://sylvana.net/jpegcrop/jpegtran/\n\nInstall with python dependencies\n```bash\npython -m pip install pypiwin32 photo-importer\n```\n\n## Usage\n### Command-Line Interface\n\n```bash\nphoto-importer /path/to/media/files\n```\nWill process files (reanaming/rotating) in-place.\n![In place example](https://user-images.githubusercontent.com/28735879/76139947-bd249780-6055-11ea-85c0-0985b6bde93f.png)\n\n```bash\nphoto-importer /path/to/media/files /output/path\n```\nWill 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\n\n![Move example](https://user-images.githubusercontent.com/28735879/76139964-eba27280-6055-11ea-988f-aa71cda7ba36.png)\n\n### Web Interface\n  * attach usb-drive / usert memory card\n  * open http://servername:8080\n  * click \"Mount\"\n  * click \"Import\"\n  * click \"Unmount\"\n\n![Web interface example](https://user-images.githubusercontent.com/28735879/76140174-f1995300-6057-11ea-8718-19c38650c786.png)\n\n### Windows command line\n```bash\ncd photo_importer\nrun.py -c ..\\photo-importer-win.cfg path\\to\\media\\files \\output\\path\n```\n### Windows web \n```bash\nphoto-importer-server.bat\n```\n\n## Configuration\nThe server config file located in /etc/photo-importer.cfg\n\nCommand line tool config file located in ~/.photo-importer.cfg\n\nAlso config file can be specified by mean of -c command line option.\n\nFor options details see comments in the config file.\n\n## Acknowledgements\nThanks to everyone who tested and gave advice.\n\n**Bug reports, suggestions and pull request are welcome!**\n\n## Show your support\nGive a ⭐️ if this project helped you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsashacmc%2Fphoto-importer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsashacmc%2Fphoto-importer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsashacmc%2Fphoto-importer/lists"}