sij/pathScripts
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Auto-update: Sat Oct 26 14:09:48 PDT 2024

Browse source
This commit is contained in:
sanj 2024-10-26 14:09:48 -07:00
parent 31375d134b
commit 1c739f4194
1 changed files with 72 additions and 116 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

188
README.md
View file

@ -1,58 +1,57 @@
# PATH-worthy Scripts # PATH-worthy Scripts 🛠️
Hey folks, this repo is just a collection of various scripts I use frequently enough to justify keeping them in my system PATH. I haven't written documentation for all of these scripts. I might in time. For now, here's just a few highlights. A collection of useful scripts for your system PATH. Here's how to get started:
## bates ## Installation
A simple Python-based utility for extracting Bates numbers from PDF documents and optionally renaming files based on those numbers. Particularly useful for organizing legal documents or any PDFs with sequential numbering. ```bash
# Clone the repository
git clone https://sij.ai/sij/pathScripts.git
### Overview # Add to PATH on macOS
echo 'export PATH="$PATH:$HOME/path/to/pathScripts"' >> ~/.zshrc
source ~/.zshrc
This tool helps you: # Add to PATH on Debian/Ubuntu
- Extract Bates numbers from PDFs (both text-based and scanned documents) echo 'export PATH="$PATH:$HOME/path/to/pathScripts"' >> ~/.bashrc
- Rename files based on their Bates number range source ~/.bashrc
- Preserve original filenames in macOS Finder comments ```
- Process entire folders of PDFs in one go
- Prepare files for use with my [Bates Source Link](https://sij.ai/sij/DEVONthink/src/branch/main/Bates%20Source%20Link.scpt$0) DEVONthink script
### Installation Make scripts executable:
```bash
cd pathScripts
chmod +x *
```
1. Install Python dependencies: ---
## 📄 bates - PDF Bates Number Tool
Extracts and renames PDFs based on Bates numbers.
### Setup
```bash ```bash
pip3 install pdfplumber pip3 install pdfplumber
``` # For OCR support:
If you plan to use OCR capabilities, also install:
```bash
pip3 install pytesseract pdf2image pip3 install pytesseract pdf2image
brew install tesseract poppler # macOS
# or
sudo apt-get install tesseract-ocr poppler-utils # Debian
``` ```
2. For OCR support, install system dependencies: ### Usage
On macOS:
```bash ```bash
brew install tesseract poppler bates /path/to/folder --prefix "FWS-" --digits 6 --name-prefix "FWS "
``` ```
On Ubuntu/Debian: ### Key Features
```bash - Extracts Bates numbers from text/scanned PDFs
sudo apt-get install tesseract-ocr poppler-utils - Renames files with number ranges
``` - Preserves original names in Finder comments
- OCR support for scanned documents
### Basic Usage - Dry-run mode with `--dry-run`
Test extraction without renaming files:
```bash
python3 bates.py /path/to/folder --prefix "FWS-" --digits 6 --dry-run
```
Rename files based on Bates numbers:
```bash
python3 bates.py /path/to/folder --prefix "FWS-" --digits 6 --name-prefix "FWS "
```
### Options ### Options
- `--prefix`: The Bates number prefix to search for (default: "FWS-") - `--prefix`: The Bates number prefix to search for (default: "FWS-")
- `--digits`: Number of digits after the prefix (default: 6) - `--digits`: Number of digits after the prefix (default: 6)
- `--ocr`: Enable OCR for scanned documents - `--ocr`: Enable OCR for scanned documents
@ -60,110 +59,67 @@ python3 bates.py /path/to/folder --prefix "FWS-" --digits 6 --name-prefix "FWS "
- `--name-prefix`: Prefix to use when renaming files - `--name-prefix`: Prefix to use when renaming files
- `--log`: Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) - `--log`: Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
### Notes ### Examples
```bash
# Test without making changes
bates /path/to/pdfs --prefix "FWS-" --digits 6 --dry-run
# Rename files with OCR support
bates /path/to/pdfs --prefix "FWS-" --digits 6 --name-prefix "FWS " --ocr
```
### Notes
- Always test with `--dry-run` first - Always test with `--dry-run` first
- Original filenames are preserved in Finder comments (macOS only) - Original filenames are preserved in Finder comments (macOS only)
- OCR is disabled by default to keep things fast - OCR is disabled by default to keep things fast
---
## 🔒 vpn - Tailscale Exit Node Manager
Privacy-focused Tailscale exit node management.
## vpn ### Setup
A command-line utility for managing Tailscale exit nodes with privacy-focused features.
### Overview
This tool helps you:
- Start and stop Tailscale exit nodes
- Select new exit nodes automatically
- Choose random exit nodes from privacy-friendly countries
- Verify successful connections using Mullvad's API
### Requirements
- Python 3
- Tailscale installed and configured
- `requests` Python package
Install dependencies:
```bash ```bash
pip3 install requests pip3 install requests
``` ```
### Usage ### Usage
```bash ```bash
python3 vpn.py <action> vpn <action> # actions: start, stop, new, shh
``` ```
#### Available Actions ### Actions
- `start`: Connect to a suggested exit node if not already connected - `start`: Connect to a suggested exit node if not already connected
```bash
python3 vpn.py start
```
- `stop`: Disconnect from current exit node - `stop`: Disconnect from current exit node
```bash
python3 vpn.py stop
```
- `new`: Switch to a new suggested exit node - `new`: Switch to a new suggested exit node
```bash
python3 vpn.py new
```
- `shh`: Connect to a random exit node in a privacy-friendly country - `shh`: Connect to a random exit node in a privacy-friendly country
```bash
python3 vpn.py shh
```
### Privacy Features ### Key Features
- Auto-connects to suggested nodes
The script considers the following countries as privacy-friendly for the `shh` command: - Privacy-friendly country selection (SE, CH, DE, FI, NL, NO)
- Sweden - Connection verification via Mullvad API
- Switzerland - Default Tailscale arguments:
- Germany - `--exit-node-allow-lan-access`
- Finland - `--accept-dns`
- Netherlands - `--accept-routes`
- Norway
### Configuration
The script uses these default Tailscale arguments:
- `--exit-node-allow-lan-access`: Allow access to LAN while using exit node
- `--accept-dns`: Use DNS settings from the exit node
- `--accept-routes`: Accept advertised routes from the exit node
### Verification
The script verifies successful connections by:
1. Checking Tailscale's reported exit node
2. Verifying the connection using Mullvad's API
3. Confirming the hostnames match
### Examples ### Examples
Start using an exit node:
```bash ```bash
$ python3 vpn.py start vpn start # Connect to suggested node
Suggested exit node: stockholm.ts.net vpn shh # Connect via privacy-friendly country
Current exit node hostname: stockholm
Exit node set successfully!
``` ```
Switch to a privacy-focused node: ### Verification
```bash - Checks Tailscale's reported exit node
$ python3 vpn.py shh - Verifies connection using Mullvad's API
Selected random privacy-friendly exit node: zurich.ts.net - Confirms hostname matches
Current exit node hostname: zurich
Exit node set successfully!
```
### Notes ### Notes
- Requires active Tailscale configuration
- Internet connectivity needed for verification
- Some commands may need admin privileges
- The script requires an active Tailscale configuration ---
- Internet connectivity is required for verification
- Some commands may require administrative privileges _More scripts will be documented as they're updated. Each script includes `--help` for detailed usage information._