I download a lot of academic papers and reports, and my downloads folder was a mess of files like `1234.5678.pdf` or `whitepaper_v2_final.pdf`. Manually renaming them was a huge time sink.

To solve this, I built Ramener. It's a native macOS app that: 1. Reads the first few pages of a PDF. 2. Uses an LLM (Aliyun's qwen3-omni-flash) to extract the title, source, and date. 3. Renames the file to a clean `YYYY-MM-DD_Source_Title.pdf` format.

The main goal was to make it feel like part of the OS. It's a standalone app, not a web service. You can integrate it directly into Finder's toolbar or Quick Actions menu, so you can rename files with a single click without leaving Finder. It also has a CLI for power users and scripting.

On first launch, a native settings window pops up for your API key, which is then stored locally.

It's built with Python and packaged with PyInstaller. The code is open source, and I'd love to get your feedback on the workflow, the integrations, or any bugs you find.

GitHub link: https://github.com/jollychang/ramener