pixa 0.1.1

Fast image processing CLI: compress, resize, convert, split sprite sheets, generate favicons, and remove Gemini AI watermarks. One command for AI-image-to-web optimization.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

mod commands;

use anyhow::Result;
use clap::{Parser, Subcommand};

use commands::{compress, convert, detect, favicon, info, install, remove_watermark, split};

const EXAMPLES: &str = "\
Examples:
  pixa remove-watermark image.jpg -o clean.jpg
  pixa remove-watermark ./photos -r -o ./cleaned --if-detected
  pixa detect image.jpg
  pixa compress input.png -o output.png -q 80
  pixa compress ./photos -r -o ./out -q 85
  pixa convert photo.png photo.webp
  pixa convert ./photos ./out -r --format webp
  pixa info photo.jpg
  pixa favicon logo.png -o ./favicon
  pixa split sheet.png -o ./out --names neutral,happy,thinking,surprised,sad
  pixa install --skills
";

#[derive(Parser)]
#[command(
    name = "pixa",
    version,
    about = "A fast image processing toolkit",
    after_help = EXAMPLES,
)]
struct Cli {
    /// Enable verbose (debug) logging
    #[arg(short, long, global = true)]
    verbose: bool,

    #[command(subcommand)]
    command: Commands,
}

#[derive(Subcommand)]
enum Commands {
    /// Remove Gemini watermark from an image or directory
    #[command(alias = "rw")]
    RemoveWatermark(remove_watermark::RemoveWatermarkArgs),

    /// Detect whether a Gemini watermark is present
    Detect(detect::DetectArgs),

    /// Compress / optimize images (MozJPEG, OxiPNG, WebP)
    Compress(compress::CompressArgs),

    /// Convert between image formats
    Convert(convert::ConvertArgs),

    /// Show image metadata and dimensions
    Info(info::InfoArgs),

    /// Generate a web-ready favicon/icon set from an image
    Favicon(favicon::FaviconArgs),

    /// Auto-detect and crop individual objects from a sheet image
    Split(split::SplitArgs),

    /// Install integrations (Claude Code skill, etc.)
    Install(install::InstallArgs),
}

fn main() -> Result<()> {
    let cli = Cli::parse();

    let filter = if cli.verbose { "debug" } else { "warn" };
    tracing_subscriber::fmt()
        .with_env_filter(
            tracing_subscriber::EnvFilter::try_from_default_env()
                .unwrap_or_else(|_| tracing_subscriber::EnvFilter::new(filter)),
        )
        .with_target(false)
        .without_time()
        .with_writer(std::io::stderr)
        .init();

    match cli.command {
        Commands::RemoveWatermark(a) => remove_watermark::run(a),
        Commands::Detect(a) => detect::run(a),
        Commands::Compress(a) => compress::run(a),
        Commands::Convert(a) => convert::run(a),
        Commands::Info(a) => info::run(a),
        Commands::Favicon(a) => favicon::run(a),
        Commands::Split(a) => split::run(a),
        Commands::Install(a) => install::run(a),
    }
}