PyPI 官网下载 | osxphotos-0.30.2.tar.gz

# OSXPhotos [](https://github.com/python/black) [](https://opensource.org/licenses/MIT)  - [OSXPhotos](#osxphotos) * [What is osxphotos?](#what-is-osxphotos) * [Supported operating systems](#supported-operating-systems) * [Installation instructions](#installation-instructions) * [Command Line Usage](#command-line-usage) * [Example uses of the package](#example-uses-of-the-package) * [Package Interface](#package-interface) + [PhotosDB](#photosdb) + [PhotoInfo](#photoinfo) + [ExifInfo](#exifinfo) + [AlbumInfo](#albuminfo) + [FolderInfo](#folderinfo) + [PlaceInfo](#placeinfo) + [ScoreInfo](#scoreinfo) + [Template Substitutions](#template-substitutions) + [Utility Functions](#utility-functions) * [Examples](#examples) * [Related Projects](#related-projects) * [Contributing](#contributing) * [Known Bugs](#known-bugs) * [Implementation Notes](#implementation-notes) * [Dependencies](#dependencies) * [Acknowledgements](#acknowledgements) ## What is osxphotos? OSXPhotos provides the ability to interact with and query Apple's Photos.app library database on MacOS. Using this package you can query the Photos database for information about the photos stored in a Photos library on your Mac--for example, file name, file path, and metadata such as keywords/tags, persons/faces, albums, etc. You can also easily export both the original and edited photos. ## Supported operating systems Only works on MacOS (aka Mac OS X). Tested on MacOS 10.12.6 / Photos 2.0, 10.13.6 / Photos 3.0, MacOS 10.14.5, 10.14.6 / Photos 4.0, MacOS 10.15.1 - 10.15.5 / Photos 5.0. Requires python >= 3.8. You can probably get this to run with Python 3.6 or 3.7 (see notes [below](#Installation-instructions)) but only 3.8+ is officially supported. This package will read Photos databases for any supported version on any supported OS version. E.g. you can read a database created with Photos 4.0 on MacOS 10.14 on a machine running MacOS 10.12. ## Installation instructions OSXPhotos uses setuptools, thus simply run: python3 setup.py install If you're using python 3.6 or 3.7, you'll need to do this first to get around an issue with bpylist2: pip install -r requirements.txt You can also install directly from [pypi](https://pypi.org/) but you must use python >= 3.8 to avoid an error with bpylist2. The package currently works fine with python 3.6 or 3.7 but I know of no way to get `pip` to install the right dependencies. pip install osxphotos ## Command Line Usage This package will install a command line utility called `osxphotos` that allows you to query the Photos database. Alternatively, you can also run the command line utility like this: `python3 -m osxphotos` If you only care about the command line tool, you can download an executable of the latest [release](https://github.com/RhetTbull/osxphotos/releases). Alternatively, I recommend installing with [pipx](https://github.com/pipxproject/pipx) After installing pipx: `pipx install osxphotos` Then you should be able to run `osxphotos` on the command line: ``` > osxphotos Usage: osxphotos [OPTIONS] COMMAND [ARGS]... Options: --db <Photos database path> Specify Photos database path. Path to Photos library/database can be specified using either --db or directly as PHOTOS_LIBRARY positional argument. If neither --db or PHOTOS_LIBRARY provided, will attempt to find the library to use in the following order: 1. last opened library, 2. system library, 3. ~/Pictures/Photos Library.photoslibrary --json Print output in JSON format. -v, --version Show the version and exit. -h, --help Show this message and exit. Commands: albums Print out albums found in the Photos library. dump Print list of all photos & associated info from the Photos... export Export photos from the Photos database. help Print help; for help on commands: help <command>. info Print out descriptive info of the Photos library database. keywords Print out keywords found in the Photos library. labels Print out image classification labels found in the Photos... list Print list of Photos libraries found on the system. persons Print out persons (faces) found in the Photos library. places Print out places found in the Photos library. query Query the Photos database using 1 or more search options; if... ``` To get help on a specific command, use `osxphotos help <command_name>` Example: `osxphotos help export` ``` Usage: osxphotos export [OPTIONS] [PHOTOS_LIBRARY]... DEST Export photos from the Photos database. Export path DEST is required. Optionally, query the Photos database using 1 or more search options; if more than one option is provided, they are treated as "AND" (e.g. search for photos matching all options). If no query options are provided, all photos will be exported. By default, all versions of all photos will be exported including edited versions, live photo movies, burst photos, and associated RAW images. See --skip-edited, --skip-live, --skip-bursts, and --skip-raw options to modify this behavior. Options: --db <Photos database path> Specify Photos database path. Path to Photos library/database can be specified using either --db or directly as PHOTOS_LIBRARY positional argument. If neither --db or PHOTOS_LIBRARY provided, will attempt to find the library to use in the following order: 1. last opened library, 2. system library, 3. ~/Pictures/Photos Library.photoslibrary -V, --verbose Print verbose output. --keyword KEYWORD Search for photos with keyword KEYWORD. If more than one keyword, treated as "OR", e.g. find photos matching any keyword --person PERSON Search for photos with person PERSON. If more than one person, treated as "OR", e.g. find photos matching any person --album ALBUM Search for photos in album ALBUM. If more than one album, treated as "OR", e.g. find photos matching any album --folder FOLDER Search for photos in an album in folder FOLDER. If more than one folder, treated as "OR", e.g. find photos in any FOLDER. Only searches top level folders (e.g. does not look at subfolders) --uuid UUID Search for photos with UUID(s). --title TITLE Search for TITLE in title of photo. --no-title Search for photos with no title. --description DESC Search for DESC in description of photo. --no-description Search for photos with no description. --place PLACE Search for PLACE in photo's reverse geolocation info --no-place Search for photos with no associated place name info (no reverse geolocati