https://github.com/rplanier/govos-document-downloader
A userscript that enables downloading PublicSearch.us document preview images as compiled PDF documents
https://github.com/rplanier/govos-document-downloader
document download govos pdf publicsearch userscript
Last synced: about 2 months ago
JSON representation
A userscript that enables downloading PublicSearch.us document preview images as compiled PDF documents
- Host: GitHub
- URL: https://github.com/rplanier/govos-document-downloader
- Owner: rplanier
- Created: 2025-02-19T05:26:23.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-24T16:37:30.000Z (3 months ago)
- Last Synced: 2026-03-25T21:44:06.505Z (3 months ago)
- Topics: document, download, govos, pdf, publicsearch, userscript
- Language: JavaScript
- Homepage:
- Size: 590 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GovOS Document Downloader
GovOS Document Downloader is a userscript that modifies the document preview pages on GovOS public records access platforms (e.g., PublicSearch.us) to enable downloading of watermarked PDF documents and quick instrument searching. The script compiles individual document page preview images into a single PDF document.
> [!IMPORTANT]
> Document page previews must be available to compile a PDF document, but some counties do not permit public page previews. If a particular county does not permit free public page previews, then this userscript will not work for that county.
> [!NOTE]
> This script merely compiles publicly available page preview images into a single PDF document and does not enable downloading of clean (unwatermarked) documents or unlock paywalled content or features.
## Installation Instructions
1. Install a userscript web browser extension like [Violentmonkey](https://violentmonkey.github.io/) (recommended) or [Tampermonkey](https://www.tampermonkey.net/) to your web browser.
2. Open the [latest version](https://raw.githubusercontent.com/rplanier/govos-document-downloader/master/govos-document-downloader.user.js) of this userscript in your web browser. Your userscript web browser extension should prompt you to install the userscript.
> [!CAUTION]
> Userscript web browser extensions allow installed scripts to execute JavaScript on website pages which match one or more given URL patterns. Given the power that these web browser extensions can potentially unlock, you should only install userscripts from trusted sources!
## Usage Instructions
1. Visit the document preview page of any document on a GovOS public record access platform (e.g., `https://[county][state].publicsearch.us/doc/[document-number]`). The document preview page typically provides a watermarked document preview and a summary of the document details.
2. A green 'Download' button will now be inserted at the top of the document preview window. Click the button and **wait for the document to compile and automatically download**. Compiling the PDF may take up to one second per page.
3. A small web form next to the 'Download' button allows for quick searching of instruments by volume and page number.
4. Search results tables are automatically expanded to fill the entire page width for easier viewing.
5. If the 'Download' button or the search form do not automatically appear, refresh the document preview page to force the userscript to reload.
6. Upon clicking the 'Download' button, a prompt will ask you for the preferred filename. The default filename is `[document-number]_V[volume] P[page]_[county] [state].pdf`.
## Screenshots
