Skip to content

photils-cli is an application that passes an image through a neural network, classifies it, and extracts the suggested tags. Everything happens offline without the need that your data are sent over the internet.

License

scheckmedia/photils-cli

master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
res
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

photils-cli

Build Status

Photils-cli is an application that passes an image through a neural network, classifies it, and extracts the suggested tags. Everything happens offline without the need that your data are sent over the internet.

The reason for this application is mainly the integration into darktable as plugin.

Installation

Linux

  1. Download the latest release
  2. Copy the photils-cli.AppImage at some safe pleace
  3. Make the AppImage executable: https://youtu.be/nzZ6Ikc7juw

MacOS

  1. Download the latest release
  2. Extract the zip and copy the photils-cli.app at some safe pleace

Windows

work in progress

Usage

Linux:

$ ./photils-cli.AppImage --image ~/Pictures/_DSC2437.jpg

MacOS:

$ ./photils-cli.app/Contents/MacOS/photils-cli --image ~/Pictures/_DSC2437.jpg

Args

photils-cli [OPTION...]

  -h, --help             print this help
  -v, --version          print version
  -i, --image arg        Image to predict keywords
  -o, --output_file arg  File where to write keywords. Optional (default: "")
  -c, --with_confidence  If flag is used a confidence value for each
                         prediction is printed as well. Optional

Tag translation

photils comes with a fixed list of ~3700 available tags. In some cases, the language or space-less tag style does not fit your workflow. For such cases, you have the option to override tags with your own style. For example, if you don't like the blackbackground tag and want black background instead, you can user the override file to fix this. You can also use it to translate the tags to the language of your choice.

All what you need is to place a file named override_labels.json in the folder:

OS Path
MacOS $HOME/Library/Application Support/photils/override_labels.json
Linux $HOME/.local/share/photils/override_labels.json

with a structure like:

{
  "tag_name": "new_tag_name"
}

For example, a simple translation into German of 4 tags looks like this:

{
    "art": "kunst",
    "shadow": "schatten",
    "light": "licht",
    "blackbackground": "schwarzer hintergrund"
}

If you have done a translation of the available tags, please share it with us for the community. Thanks!

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

GPLv3

About

photils-cli is an application that passes an image through a neural network, classifies it, and extracts the suggested tags. Everything happens offline without the need that your data are sent over the internet.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published