Skip to main content

A cli tool for managing documents and media files

Project description

futils

A CLI tool to automate repetitive tasks during management of documents and media files

Usage

fu [OPTIONS] COMMAND [ARGS]...

Available commands

  • config View, initialize, or edit application configuration.
  • imgresize Resize images to smaller resolutions applying same effect as 'cover' css, useful for wallpapers and background images management.
  • index: Creates a text file listing all files at given path in ascending order. Only direct children files.
  • index-removed: Creates a text file listing all files that are present in a given index but doesn't exists in specified path anymore.
  • iterate Iterates files in a path and opens it in default application, useful for review pictures or multiple docs in a folder.
  • iteratefrom Iterates each line of given file as a path and will open it in default system program.
  • rm-indexed Permanently removes all files listed in a given index.

Sub-apps

  • exif EXIF-related commands (e.g. fu exif ls).
  • movie Movie file commands:
    • fix-name Assists in renaming movie files into a scanner-friendly format: <Title> (Year) - <Resolution> <Audio Lang> <Extra>.<ext>. Great for Plex 😉
  • tv-show TV show file commands:
    • fix-names Assists in renaming TV show episode files into a format like <Show title> (Year) - S<Season>E<Episode> - <Title> <Resolution>.<ext>.

Usage details for each subcommand

Use --help option to get details about each arguments, option and usage for each command

# Show help for 'imgresize' command
fu imgresize --help

Output for above command:

Usage: fu imgresize [OPTIONS] [SRC_DIR]

  Resize images to smaller resolution applying same effect as css 'cover'

Arguments:
  [SRC_DIR]  Directory containing images to resize  [default: ./]

Options:
  -w, --width INTEGER   Desired width in pixels  [default: 1920]
  -h, --height INTEGER  Desired height in pixels  [default: 1080]
  -d, --dst-dir TEXT    Destination directory for resized images
  --help                Show this message and exit.

Install

Using pip

pip install futils

futils depends on python 3, in some systems you may want to use pip3 to install programs into python 3 environment

Development

Check Development section

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

futils-1.3.6.tar.gz (25.5 kB view details)

Uploaded Source

File details

Details for the file futils-1.3.6.tar.gz.

File metadata

  • Download URL: futils-1.3.6.tar.gz
  • Upload date:
  • Size: 25.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.12

File hashes

Hashes for futils-1.3.6.tar.gz
Algorithm Hash digest
SHA256 d9a2edbfa4a1f43a57d8bf7d784a45c03de43a8fdb59e05db8e1b705e19cf1ab
MD5 b6dc9ed8a7d87cb6a707ee9af7b05889
BLAKE2b-256 52e1682b85ebb30369156b8acc43c0a9a09da9d9d7ce4f1a1bcabd1eca83a82f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page