Skip to content

Easily rename your academic paper file to more readable name using the title of the paper.

License

Notifications You must be signed in to change notification settings

huwan/PaperRenamer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Paper Renamer

Easily rename your academic paper file to more readable name using the title of the paper.

PaperRenamer Demo

Paper Renamer for MacOS

Paper Renamer is a dedicated MacOS application that transforms the pdftitle Python script into a native MacOS app using Platypus. It packages the script into a MacOS application bundle, complete with an executable that runs the script.

Installation

Available packages

  • Download the latest DMG file from the releases page here. Choose between Paper Renamer and Paper Renamer Daemon depending on your requirements. For background renaming of papers without a GUI, right-click on PDF files and select "Open With Paper Renamer Daemon."
  • Open the DMG file by double-clicking it, which will display a Finder window. Drag the app icon to your Applications folder to install.

Manual build and installation

A Platypus profile is provided to save the configuration settings necessary for building the app. You can find the Python script, pdftohtml tool, and icon files in the Resources directory.

  • First, install Platypus.
  • Open the Paper Renamer.platypus profile by double-clicking, or load it in Platypus via the menu (Profiles → Load Profile...). Adjust the configuration as needed.
  • Press "Create App" to build the application.
  • Transfer the Paper Renamer.app into your Applications folder.

Usage

Launch Paper Renamer.app to start renaming your PDF files. You can rename files by dragging and dropping them into the app’s window or by selecting files through the menu.

For a quick rename, right-click on a PDF file, select "Open With," and then choose "Paper Renamer" to automatically rename the file based on its title. For an improved experience, it is recommended to change the Platypus Interface option from Droplet to None. This will ensure that no GUI window appears, allowing for silent renaming without interruption.

Credits

Special thanks to Uwe Dauernheim for developing the pdftitle tool, Sveinbjorn Thordarson for creating Platypus, and Sindre Sorhus for the create-dmg tool which simplifies DMG creation.

Acknowledgements

  • poppler (pdftohtml), a PDF rendering library.
  • FreeType, a freely available software library to render fonts.
  • Fontconfig, a library for configuring and customizing font access.
  • libjpeg, a free library for JPEG image compression.
  • libpng, the free reference library for reading and writing PNGs.
  • LibTIFF, a library for reading and writing TIFF.

License

The code is available under the BSD 2-Clause "Simplified" License. The icon, created by phatplus from www.flaticon.com, is licensed under CC 3.0 BY.

About

Easily rename your academic paper file to more readable name using the title of the paper.

Resources

License

Stars

Watchers

Forks

Packages

No packages published