Pikapika

A Python CLI utility to organize your folders by file extension

View on GitHub Install from PyPI

See Pikapika in Action

Watch how pikapika organizes files automatically with just a simple command

Features

🔍

Dry Run Mode

Preview all planned operations before making any changes to your files

📁

Smart Categorization

Automatically organize files into categories using customizable extension mappings

🗑️

Junk Handling

Quarantine or trash incomplete downloads and temporary files safely

🔄

Duplicate Safety

Automatically rename conflicts to prevent overwriting existing files

🌲

Recursive Mode

Organize nested folders while intelligently skipping system directories

⚙️

Highly Configurable

Customize categories, file extensions, and behavior to match your workflow

Quick Start

Install from PyPI

pip install pikapika-organizer Copy

Run with uvx (No Install)

uvx pikapika-organizer Copy

Usage Examples

Preview Changes (Dry Run)

pikapika-organizer --dry-run Copy

See what would happen without making any changes

Organize Specific Folder

pikapika-organizer --path "D:\Downloads" Copy

Organize a specific directory

Recursive Organization

pikapika-organizer --recursive --quarantine-junk --junk-days 10 Copy

Organize subdirectories and quarantine old junk files

Send Junk to Trash

pikapika-organizer --quarantine-junk --trash-junk Copy

Move junk files to system trash instead of quarantine

Command Line Options

Flag	Description
--path PATH	Downloads directory to organize (defaults to user's Downloads folder)
--dry-run	Print intended operations without touching the filesystem
--recursive	Walk subdirectories (skips system folders automatically)
--quarantine-junk	Move old junk files to _Quarantine folder
--junk-days N	Minimum age (days) for junk files before action (default: 7)
--trash-junk	Send junk files to OS trash (requires send2trash)