What is hokou-shorts-bot?

hokou-shorts-bot is a command line automation tool that finds short YouTube videos matching a search query, trims and reformats them, appends a custom call to action outro, and uploads the results to a YouTube channel as Shorts on a recurring schedule. The pipeline has three stages. First, the scrape step uses yt-dlp, a widely used command line video downloader, to pull the top results for a configurable search query, defaulting to "satisfying 3d animation", filtering for clips between 3 and 65 seconds long. Second, the process step uses ffmpeg, a video processing tool, to normalize each clip to a vertical 1080x1920 format at 30 frames per second, trim it to a set duration (defaulting to 2 seconds), and splice on a pre made outro video that you provide. Third, the upload step picks the oldest unprocessed clips from the output folder and pushes them to YouTube via the official YouTube Data API, tracking what has already been posted in a local file called posted.json. Authentication with YouTube uses the OAuth flow: you run a one time auth command that walks you through authorization and gives you a refresh token to store in a configuration file. From that point on, uploads happen without further login prompts. For automated scheduling, the project includes a macOS LaunchAgent configuration file that runs the upload step daily at 9:00 AM. You install it by copying the file into the system's LaunchAgents folder. All raw downloads and intermediate files are kept out of version control, only the posting ledger is tracked. The project is written in TypeScript and requires yt-dlp and ffmpeg to be installed separately.