Skip to content

drarahimi/bib-cleaner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

Bib Cleaner Pro 🧹📚

Bib Cleaner Pro is a fast, secure, and fully browser-based utility designed to tidy up messy LaTeX bibliographies. Instead of manually curating a massive master .bib file, simply upload your .tex files alongside your bibliography, and Bib Cleaner Pro will extract, clean, format, and update only the references you actually need.

HTML5 JavaScript TailwindCSS

✨ Features

  • Targeted Extraction: Reads your .tex files (supporting \cite, \footcite, \autocite, etc.) and pulls only the used entries from your master .bib file.
  • Smart Deduplication: Identifies and merges duplicate entries based on DOI or Title + Year matches.
  • Automated Metadata Updates: Fetches clean, updated bibliography data directly via the Crossref API for any entry containing a DOI.
  • Citekey Standardization: Automatically renames your messy citekeys to a clean AuthorYearTitle format. If citekeys are updated or duplicates are merged, the tool generates an updated .tex file for you to download in a ZIP archive.
  • Missing Tag Detection: Alerts you if your .tex documents reference citekeys that do not exist in your master .bib file.
  • Rich Analytics Dashboard: Generates beautiful visualizations of your bibliography using Chart.js, including:
    • Publication year distributions
    • Top authors and venues/journals
    • Entry type breakdowns
    • DOI coverage percentages
  • 100% Client-Side Processing: All parsing and cleaning happen entirely in your browser. No research data or bibliography files are ever uploaded to a server, ensuring total privacy for your unpublished manuscripts and grant proposals.

🚀 How to Use

Since Bib Cleaner Pro is a purely front-end application, there is no build step or backend to configure.

  1. Clone the repository or download the index.html file.
  2. Open index.html directly in any modern web browser.
  3. Upload your Master Bib: Drag and drop your .bib file into the first dropzone.
  4. Upload TeX Files: Select or drag in one or more .tex documents.
  5. Select Options: Toggle your preferred processing options (e.g., Crossref updates, standardizing citekeys, merging duplicates).
  6. Clean: Click "Clean Bibliography" and review your results in the output pane or the statistics dashboard. Download your new files instantly.

🛠️ Processing Options Explained

  • Remove excessive blank lines: Condenses spacing between entries for a tighter file.
  • Format & Indent: Standardizes all inner fields to uniform 2-space indents.
  • Merge Duplicates: Routes citations from duplicate references to a single, unified entry.
  • Provide Deleted Entries file: Gives you a separate .bib download containing the references that were discarded or merged.
  • Update via Crossref API: Replaces messy or incomplete manual entries with official Crossref metadata if a DOI is present.
  • Standardize Citekeys: Enforces the AuthorYearTitle format. Note: Selecting this will prompt a download of your updated .tex files so your citations don't break!

📦 Dependencies

This tool relies on the following libraries via CDN:

  • Tailwind CSS - For modern, responsive styling.
  • JSZip - For bundling updated .tex files into a single downloadable archive.
  • Chart.js - For rendering the academic meta-statistics dashboard.

📄 License

This project is open-source and available under the MIT License.

About

A powerful, completely browser-based tool to clean, format, deduplicate, and standardize LaTeX bibliography (.bib) files based on the citations actually used in your .tex documents.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages