Add release download badge and detailed description to README

README.md

@@ -1,11 +1,28 @@
 # Zotero PDF Copier & Renamer
 
+[![Download XPI](https://img.shields.io/badge/Download-zotero--pdf--copier--renamer.xpi-brightgreen?style=for-the-badge&logo=github)](https://github.com/iu-parvej/Zotero-PDF-Copier-Renamer/releases/download/v1.0.0/zotero-pdf-copier-renamer.xpi)
+
 A powerful, lightweight, and restartless add-on for **Zotero 7, 8, and 9** that lets you copy attached PDF documents from selected bibliography references into any folder on your computer. Copied PDFs are automatically renamed based on the paper's title (sanitized for safe OS filenames) and index-deduplicated.
 
 Developed and designed with custom branding and a native graphical interface.
 
 ---
 
+## Detailed Description
+
+**Zotero PDF Copier & Renamer** is a specialized, production-grade productivity add-on engineered specifically for academic researchers, students, and professionals who manage large volumes of scientific literature in Zotero 7, 8, and 9. While Zotero excels at indexing bibliographic metadata, retrieving files, and synchronizing collections across devices, extracting attachments for external sharing, archiving, or mobile reading has historically been a cumbersome chore. Attachment files are stored inside deeply nested, cryptically named directories within the local Zotero storage folder, making them nearly impossible to navigate manually. 
+
+This extension bridges that gap by providing a seamless, single-click utility that extracts PDF attachments directly from your selected library entries and copies them to any target directory on your computer, while dynamically renaming each file based on its official bibliographic title. 
+
+### Why It Is Essential
+
+1. **Elimination of Cryptic Folder Names**: By default, Zotero stores attachments in isolated folders named with random alphanumeric hashes (e.g., `8WHS8FK2`). When you need to copy a group of papers to a flash drive, email them to a collaborator, or read them on a tablet, finding these files manually is incredibly tedious. This extension handles the heavy lifting, consolidating the PDFs into a single, clean directory of your choosing.
+2. **Metadata-Driven Renaming**: Instead of keeping default, unhelpful filenames like `fulltext.pdf` or `manuscript.pdf`, the extension extracts the exact "Title" field from your Zotero reference entry. It then cleanses the text—removing illegal operating system path characters (like `:`, `?`, `/`, `\`)—and renames the PDF to match the paper's title (e.g., `Tropical Cyclone Simulations with WRF.pdf`).
+3. **Collision & Suffix Handling**: Scientific publications sometimes share identical titles, or a single reference entry may contain multiple PDF files (such as main articles, supplemental files, and preprints). To prevent files from overwriting each other, the extension automatically detects naming conflicts in your destination folder and appends index tags (e.g. `Paper Title_(1).pdf`), ensuring that no research data is ever lost.
+4. **Modern Zotero 9 Integration**: Built directly on Zotero's modern bootstrapped architecture, this plugin integrates natively with the Zotero user interface. It features a custom context menu icon and utilizes an animated graphical progress bar (`ItemProgress`) that provides real-time percentage feedback during bulk copy operations. Once the transfer is complete, a double-redundant close timer automatically cleans up the UI after 5 seconds, maintaining a clutter-free workspace.
+
+---
+
 ## Developer Details
 
 - **Author**: Md. Parvej Hossain