Package: clonwn-sort
Clown SortSometimes someone is being a clown on the internet. Somewhere on your hard drive is the perfect screenshot to prove to the world that the clown in question is a fool, a hypocrite, a criminal, or worse. But then - horrors - you can't find the screenshot! It has been lost in your vast archive of screenshots of clowns clowning themselves on the internet.Clown Sort solves this.What It DoIt sorts screenshots, PDFs, etc. based on their name and/or their textual contents into folders based on a list of rules. The contents of the tweet/reddit post/whatever are prepended to the filename and theImageDescriptionEXIF tag is set to the OCR text. As you can configure your own arbitrary rules and run it against any set of images it works on many things other than screenshots of social media clowns, though the default configuration is for cryptocurrency clowns.For example this screenshot of a tweet by a noteworthy cryptocurrency "reporter"[^1] on the eve of FTX's implosion:Would be renamed fromScreen Shot 2023-02-17 at 7.11.37 PM.pngtoTweet by @lawmaster: "I will say though before this thread gets taken over: 1. I do believe Alameda has the size to easily buy Binance\'s FIT OTC 2. I think the chance of FTX insolvency is near" Screen Shot 2023-02-17 at 7.11.37 PM.pngOther stuff that happens:TheImageDescriptionEXIF tag will be written (for images)All timestamps will be preserved.Files that match multiple patterns will be copied to multiple destination folders.The original file will be moved into aProcessed/directory after it has been handled.Note also that:This works on images that are more substantive than just self-clowning screenshots.So far only Tweets and Reddit screenshots have special handling beyond OCR text extraction.PDFs can be sorted by contents or filename, e.g. a PDF namedNorton Anthology of Crypto Bro Poetry.pdfcontaining iambic verse like"Fuck u justin sun  and fuck ur dick face... u all play with investing and money of the people !!!!"by the noted bard JOKER_OF_CRYPTO will be copied to theJustin Sun/folder but not renamed.Videos are not OCRed and can only be moved based on filename matches, e.g. a file calledSBF is a big fat liar.movwill be moved to theFTX/folder but otherwise left alone.Quick Start# Installation with pipx is preferred if you have it but you can also use pip which comes standard# on almost all systems. pipx is only a noticeably better answer if you're a python programmer who# is concerned about side effects of pip upgrading system python packages.pipinstallclown_sort# Get helpsort_screenshots-h# Dry run with default cryptocurrency sort rules (dry runs don't actually move anything,# they just show you what will happen if you run again with the --execute flag)sort_screenshots# Execute default cryptocurrency sort rules against ~/Pictures/Screenshotssort_screenshots--execute# Sort a different directory of screenshotssort_screenshots--screenshots-dir/Users/hrollins/Pictures/get_in_the_van/tourphotos--execute# Sort with custom rulessort_screenshots--rules-csv/Users/hrollins/my_war.csv--executeSetuppip install clown_sortOptional ComponentsIf you want to use the popup window to manually tag you may need to install:Python TK:brew install python-tk@3.10(if you don't havehomebrewyou need to install it to runbrew install)Not required for standard PNG, JPG, etc. images but you may optionally installexiftoolfor other file types.ExifTool:brew install exiftoolor download fromhttps://exiftool.orgUsageHelp screen:Custom Sorting RulesThe default is to sort cryptocurrency related content but you can define your own CSV of rules with two columnsfolderandregex. The value infolderspecifies the subdirectory to sort into andregexis the pattern to match against. Seethe default crypto related configurationfor an example. An explanation of regular expressions is beyond the scope of this README but many resources are available to help. if you're not good at regexes just remember that any alphanumeric string is a regex that will match that string.pythexis a great website for testing your regexes.[^1]: Perhaps notable that the "reporter" in question for years maintained a private list of the blockchain addresses of Sam Bankman-Fried's various scams as part of his commitment to "unrivaled transparency".