photein 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 852660eba8fefe43e1b18967162a149c13f35f85e811f08089403da3f2dd0652
-  data.tar.gz: 8a6af0e7ce270985f6a427dfc509be093d884baedccd33ac778611285fedf71a
+  metadata.gz: f2e520a4d9508ba94604273c88b9f0d3bb1052aae63cef56c856595e5b0b3866
+  data.tar.gz: 14633d71731ff23c3350c861bfe33d289bfb53777d6369a6245c203de93dacde
 SHA512:
-  metadata.gz: f7fc315331d2de5da4df3fb5aacfd7a58220f3581e3753a2c01802e428432e57ab89ac7d66c44bbecfbd8aae7f2e8966e6a18c1857ed26b68b0e2dc046bbf780
-  data.tar.gz: 27f432d3dae62069f2197051e523da3db8e3743467ce2dd17be4e7788720ef74090beb345ee98072d1df2cffe86fb7be22bde32d8d4460048eb7603f92537dbe
+  metadata.gz: cf796a670cc45ce45238b4e9b0e23641ce1dc21aa67008bb016e9507b0470bebdd4790620bfd5325eabdcbe833165588c32811b244b5f8271ff8fa05d5b2d473
+  data.tar.gz: deaea8ad0c1ad541c5e160ea927dbfef115902a7f25b96205e67c780e45477a0def030fe1dc4ba2063cc3c936fb7298ccb9f7f4dca70069e4e7ac4ec7fdd586f

data/README.md

@@ -1,29 +1,11 @@
-Ph📸tein / 🔀ferase
-===================
+Ph📸tein
+========
 
-All your photos under one roof.
+A no-nonsense way to organize your personal photo library.
 
-What do they do?
+What does it do?
 ----------------
 
-`photein` is a CLI utility for batch-importing
-your personal photos & videos into a central library.
-
-`xferase` is an always-on background service that uses `photein`
-to continuously import new photos & videos as they come in.
-
-When combined with other software,
-they can be used as a kind of self-hosted / DIY alternative
-to cloud photo services like Google Photos or iCloud.
-
-> ⚠️ **Note**
->
-> Unlike true cloud photo services,
-> this approach works by keeping a full copy of your photo library
-> in local storage on each device you sync to.
-
-### Photein
-
 Photein manages your photos **at the filesystem level**.
 It won’t let you browse or edit your photos,
 but it will give them a uniform folder structure and filenames,
@@ -55,51 +37,29 @@ based on metadata timestamps, filename timestamps, or file creation times.
 > ⚠️ **Note**
 >
 > If you use a photo management app that decides
-> where and how your photos should be stored on your system (like Apple Photos), 
-> Photein is not for you.
-
-### Xferase
-
-Xferase watches a directory of your choosing (its “inbox”),
-and whenever any files are placed there,
-it automatically imports them into your photo library.
-
-It creates and manages two parallel copies of your library
-(one original/hi-res, one optimized for web)
-and ensures that when you delete a photo from one,
-it is automatically removed from the other.
+> where and how your photos should be stored on disk
+> (👀 looking at you, Apple Photos), Photein is not for you.
 
-With the help of [Syncthing][] and systemd,
-you can automatically pull new photos from your camera or Android phone
-into Xferase’s inbox.
-Syncthing can also push your complete, web-optimized photo library
-back to your phone (or, say, push your hi-res library out to another machine).
+It can also optimize photos and videos for reduced file size.
 
-[Syncthing]: https://syncthing.net/
+What _doesn’t_ it do?
+---------------------
 
-Why?
-----
+On its own, Photein is **not** an alternative
+to cloud photo services like Google Photos or iCloud—but
+in combination with other software, it can be.
 
-I could not find any existing software product that:
+If you want to:
 
-1. imports photos from many sources\* with **no mouse or keyboard interaction**
+* import photos from your phone as soon as you take them
+* import photos from a digital camera / SD card as soon as you plug it in
+* mirror a low-res copy of your entire photo library to your Android phone
 
-   \*_e.g.,_ 📱 cell phone / 📷 digital camera / 💬 chat app download
+check out Photein’s sister utility [Xferase][],
+or try the [automation guides][] below.
 
-2. enforces a clean, consistent, **user-visible directory & filename scheme**
-
-   (I want to be able to access my photos from the file manager,
-   find them in an “Open...” dialog,
-   or sync them to other devices with generic tools
-   like rsync, Dropbox, or Syncthing.)
-
-3. comes with **no recurring subscription fee**—or better yet, is FOSS
-
-   (My digital photo/video library belongs to me,
-   but if I don’t control the pipeline for viewing/managing it,
-   then does it really?)
-
-4. works with Linux
+[Xferase]: https://github.com/rlue/xferase
+[automation guides]: #automation-guides
 
 Installation
 ------------
@@ -110,7 +70,7 @@ $ gem install photein
 
 ### Dependencies
 
-* Ruby 2.7+
+* Ruby 2.6+
 * [ExifTool][]
 * [MediaInfo][]
 * ImageMagick (for `--optimize-for=web` option)
@@ -123,8 +83,6 @@ $ gem install photein
 Usage
 -----
 
-### Simple import
-
 ```sh
 $ photein \
     --source /media/ricoh_gr/DCIM \ # batch-import photos from here
@@ -145,9 +103,17 @@ Use `photein --help` for a summary of all options.
 
 ### Automation guides
 
-* [📷➡️🖥️ Set up auto-import from a digital camera](doc/auto-import-digital-camera.md)
-* [📱➡️🖥️ Set up auto-import from an Android phone](doc/auto-import-android-phone.md)
-* [📱🔄🖥️ Mirror your library across multiple devices](doc/mirroring-a-library-on-multiple-devices.md)
+Using Photein + systemd, you can:
+
+* [📷➡️🖥️ Set up auto-import from a digital camera](guides/auto-import-digital-camera.md)
+
+But for more complex tasks, like:
+
+* 📱➡️🖥️ Setting up auto-import from an Android phone
+* 📱🔄🖥️ Mirroring your library across multiple devices
+
+check out the documentation for [Xferase][],
+an always-on background service based on Photein.
 
 Development
 -----------

data/lib/photein/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Photein
-  VERSION = '0.0.4'
+  VERSION = '0.0.5'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: photein
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Ryan Lue
@@ -154,13 +154,11 @@ description: ''
 email: hello@ryanlue.com
 executables:
 - photein
-- xferase
 extensions: []
 extra_rdoc_files: []
 files:
 - README.md
 - bin/photein
-- bin/xferase
 - lib/photein.rb
 - lib/photein/config.rb
 - lib/photein/image.rb

data/bin/xferase

@@ -1,170 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# TODO: Explain yourself
-
-# Parse opts -------------------------------------------------------------------
-require 'photein'
-require 'optparse'
-
-parser = OptionParser.new do |opts|
-  opts.version = Photein::VERSION
-  opts.banner  = <<~BANNER
-    Usage: xferase [--version] [-h | --help] [<args>]
-  BANNER
-
-  opts.on(
-    '-i INBOX', '--inbox=INBOX',
-    'path to the inbox'
-  )
-
-  opts.on(
-    '-s STAGING', '--staging=STAGING',
-    'path to the staging directory'
-  )
-
-  opts.on(
-    '-o LIB_ORIG', '--lib-orig=LIB_ORIG',
-    'path to the original/hi-res library'
-  )
-
-  opts.on(
-    '-w LIB_WEB', '--lib-web=LIB_WEB',
-    'path to the web-optimized library'
-  )
-
-  opts.on(
-    '-d INTERVAL', '--debounce=INTERVAL',
-    'wait n seconds for additional files before import'
-  )
-end
-
-begin
-  params = {}
-  parser.parse!(into: params)
-  params.freeze
-
-  %i[inbox staging lib-orig lib-web].each do |type|
-    raise "no #{type} directory given" if !params.key?(type)
-  end
-rescue => e
-  warn(e.message)
-  warn(parser.help) if e.is_a?(OptionParser::ParseError)
-  exit 1
-end
-
-# Config -----------------------------------------------------------------------
-require 'logger'
-
-DEBOUNCE_WAIT = params.fetch(:'debounce') { 60 }.to_i # seconds
-SRC_DEST_MAP = {
-  "#{params.fetch(:staging)}/desktop" => params.fetch(:'lib-orig'),
-  "#{params.fetch(:staging)}/web" => params.fetch(:'lib-web'),
-}
-
-IMPORT_CMD = %(
-  photein \
-    --verbose \
-    --source %s \
-    --dest %s \
-    --optimize-for %s
-)
-
-FORMAT_GROUPS = [%w(.jpg .dng .heic), %w(.mov .mp4), %w(.png)]
-
-LOGGER = Logger.new($stdout).tap(&:info!)
-
-# Setup ------------------------------------------------------------------------
-require 'debouncer'
-require 'fileutils'
-require 'pathname'
-require 'rb-inotify'
-require 'tmpdir'
-
-Thread.abort_on_exception = true
-SRC_DEST_MAP.keys.each(&FileUtils.method(:mkdir_p))
-
-mutex = Mutex.new
-debouncer = Debouncer.new(DEBOUNCE_WAIT) do |*files|
-  SRC_DEST_MAP.keys.each { |dir| FileUtils.ln(files, dir) }
-  FileUtils.rm(files + Dir["#{params.fetch(:staging)}/web/*.DNG"]) # FIXME (ugly hack)
-
-  break if debouncer.inspect_params[:threads] > 2 # don't let threads pile up
-
-  mutex.synchronize do
-    SRC_DEST_MAP.each do |src, dest|
-      system(IMPORT_CMD % [src, dest, src.split('/').last])
-    end
-  rescue => e
-    warn e.message
-  end
-end.reducer(:+)
-
-# Resume from interruption/failure ---------------------------------------------
-debouncer.call unless SRC_DEST_MAP.keys.all?(&Dir.method(:empty?))
-
-Dir["#{params.fetch(:inbox)}/**/*"]
-  .select(&File.method(:file?))
-  .each { |path| debouncer.call(path) }
-
-# Start ------------------------------------------------------------------------
-Thread.new do
-  call_debouncer = ->(event) do
-    debouncer.call(event.absolute_name)
-  rescue => e
-    warn e.message
-  end
-
-  import_notifier = INotify::Notifier.new
-  import_notifier.watch(params.fetch(:inbox), :close_write, &call_debouncer)
-
-  # NOTE: inotify is not recursive,
-  # so subdirectories must be watched separately!
-  # (Why do Syncthing folders get special treatment?
-  # Because ST works by creating hidden tempfiles and moving them upon completion)
-  stfolders, simple_subdirs = Dir["#{params.fetch(:inbox)}/**/*"]
-    .select(&File.method(:directory?))
-    .partition { |dir| Dir.children(dir).include?('.stfolder') }
-
-  simple_subdirs.each { |dir| import_notifier.watch(dir, :close_write, &call_debouncer) }
-  stfolders.each { |dir| import_notifier.watch(dir, :moved_to, &call_debouncer) }
-
-  import_notifier.run
-end
-
-Thread.new do
-  sync_deletions = ->(event) do
-    LOGGER.info("#{event.name} has disappeared!")
-
-    deleted_file   = Pathname(event.absolute_name).expand_path
-
-    sister_file    = if deleted_file.to_s.start_with?(File.expand_path(params['LIB_ORIG']))
-                      deleted_file.sub(*params.values_at('LIB_ORIG', 'LIB_WEB'))
-                    else
-                      deleted_file.sub(*params.values_at('LIB_WEB', 'LIB_ORIG'))
-                    end
-
-    sister_formats = FORMAT_GROUPS.find { |group| group.include?(deleted_file.extname) }
-
-    related_files  = [deleted_file, sister_file]
-      .product(sister_formats)
-      .map { |file, ext| file.sub_ext(ext) }
-      .select(&:file?)
-
-    # (Why mv to tmpdir first? Why not rm straight away?
-    # Because rm would recursively trigger this inotify callback.)
-    related_files.each { |f| LOGGER.info("deleting #{f.realpath}") }
-    FileUtils.mv(related_files, Dir.tmpdir)
-    FileUtils.rm(related_files.map { |f| File.join(Dir.tmpdir, f.basename) })
-  end
-
-  deletion_notifier = INotify::Notifier.new
-
-  # NOTE: inotify is not recursive,
-  # so subdirectories must be watched separately!
-  (Dir["#{params.fetch(:'lib-orig')}/**/*"] + Dir["#{params.fetch(:'lib-web')}/**/*"])
-    .select(&File.method(:directory?))
-    .each { |dir| deletion_notifier.watch(dir, :delete, &sync_deletions) }
-
-  deletion_notifier.run
-end.join