@hasindu---7/ff-link-extract 2.0.1 → 2.0.2

package/README.md

@@ -1,252 +1,147 @@
 # ff-link-extract
 
-Extracts direct download links from fuckingfast page links and generates clean output files.
+Extract direct download links from fuckingfast pages, store each run in a timestamped folder, and optionally auto-open links in the browser.
 
-## Commands Overview
+## NPM Commands Reference
 
-This package ships with three CLI commands:
+| Command | What It Does |
+| --- | --- |
+| `npm install` | Install project dependencies in this folder. |
+| `npm audit` | Check dependencies for known security issues. |
+| `npm outdated` | Show packages that can be updated. |
+| `npm update` | Update dependencies within allowed version ranges. |
+| `npm pkg get version` | Show current project version from package.json. |
+| `npm view @hasindu---7/ff-link-extract version` | Check latest published version on npm. |
 
-- `ff-link-extract`: Main extractor. Reads input links (plain links, HTML, or supported paste URLs) and generates direct download outputs.
-- `ff-link-extract-autorun`: Opens links from a text file in your browser at timed intervals using config settings.
-- `ff-link-extract-init`: Creates starter files (`urls.txt` and `autorun.config.json`) in your current folder.
+## Local Folder Workflow (Recommended)
 
-Quick examples:
+This guide is local-first. No global install required.
 
-```bash
-# 1) Create starter files in current folder
-ff-link-extract-init
-
-# 2) Extract direct links
-ff-link-extract -i urls.txt -o all-direct-links
-
-# 3) Open extracted links at intervals
-ff-link-extract-autorun -c autorun.config.json
-```
-
-This tool reads your source list, finds page URLs, fetches each page, and extracts the real link in this format:
-
-https://fuckingfast.co/dl/...
-
-## Who This Is For
-
-- Anyone who has a list of fuckingfast page links.
-- Users who want one-click output links.
-- Users who want both machine-readable and human-readable results.
-
-## Fastest Way To Use (Recommended)
-
-Run without installing anything:
-
-```bash
-npx -y @hasindu---7/ff-link-extract -i urls.txt -o all-direct-links
-```
-
-Why recommended:
-
-- Always uses the latest version.
-- No global install issues.
-- Works great across Windows, macOS, and Linux.
-
-## Global Install (Optional)
+### 1) Open project folder
 
 ```bash
-npm install -g @hasindu---7/ff-link-extract
+cd "c:\Users\Owner\Documents\Hasindu\Fitgirl scr"
 ```
 
-Then run:
+### 2) Install dependencies in this folder
 
 ```bash
-ff-link-extract -i urls.txt -o all-direct-links
+npm install
 ```
 
-Create starter files in your current folder:
+### 3) Create starter files in this folder
 
 ```bash
-ff-link-extract-init
+node bin/ff_extract_links_init.js
 ```
 
 This creates:
 
-- urls.txt
-- autorun.config.json
-
-So users do not need to look inside node_modules for templates.
-
-## Input File Formats
-
-The input file can be in any of these formats:
-
-- One URL per line.
-- Raw HTML blocks (including anchor tags).
-- Mixed text that contains fuckingfast links.
-- A PrivateBin paste URL (for example from paste.fitgirl-repacks.site with a key in the URL hash).
-
-Example file names:
-
-- urls.txt
-- links.txt
-- pasted-html.txt
-
-## Output Files
-
-With this command:
-
-```bash
-ff-link-extract -i urls.txt -o all-direct-links
-```
-
-You get:
-
-- links/YYYY-MM-DD_HH-mm-ss/all-direct-links.txt: Direct links only, one per line.
-- links/YYYY-MM-DD_HH-mm-ss/all-direct-links.html: Clickable links page for browser use.
-- links/YYYY-MM-DD_HH-mm-ss/all-direct-links.json: Full success and error report.
+- `urls.txt`
+- `autorun.config.json`
 
-Each run creates a new timestamped folder under links so previous runs stay saved and easy to compare.
+### 4) Put links into urls.txt
 
-## Autorun Mode (Open Links At Intervals)
+Supported input:
 
-This package also includes a second command:
+- One URL per line
+- Raw HTML anchor blocks
+- Mixed text containing links
+- PrivateBin paste URL with hash key
 
-- ff-link-extract-autorun
-
-It opens links from a text file in your default browser one by one using timed intervals.
-
-If the input file is not found in the current folder, autorun automatically tries the latest folder inside links.
-
-Default config file shipped with package:
-
-- autorun.config.json
-
-Default config values:
-
-- inputFile: all-direct-links.txt
-- intervalMs: 20000
-- startDelayMs: 3000
-- maxLinks: 999999
-- dryRun: false
-
-Example:
+### 5) Extract direct links
 
 ```bash
-ff-link-extract-autorun -c autorun.config.json
-```
-
-If you do not have config yet:
-
-```bash
-ff-link-extract-init
-ff-link-extract-autorun -c autorun.config.json
+node bin/ff_extract_links.js -i urls.txt -o all-direct-links
 ```
 
-Quick test mode without opening browser:
+### 6) Run autorun (optional)
 
 ```bash
-ff-link-extract-autorun -c autorun.config.json --dry-run
+node bin/ff_extract_links_autorun.js -c autorun.config.json
 ```
 
-Override config from command line:
+Dry-run mode (no browser open):
 
 ```bash
-ff-link-extract-autorun -i all-direct-links.txt --interval-ms 15000 --start-delay-ms 5000 --max-links 20
+node bin/ff_extract_links_autorun.js -c autorun.config.json --dry-run
 ```
 
-## Command Options
-
-- -i, --input <file>: Input file path. Default is urls.txt.
-- -o, --output-prefix <name>: Output prefix. Default is direct-links.
-- -h, --help: Show help.
-- -v, --version: Show installed version.
-
-Autorun command options:
-
-- -c, --config <file>: Config file path. Default is autorun.config.json.
-- -i, --input <file>: Links file path override.
-- --interval-ms <number>: Delay between opening each link.
-- --start-delay-ms <number>: Delay before first link opens.
-- --max-links <number>: Open only first N links.
-- --dry-run: Print schedule only. No browser opens.
+## Commands (Local)
 
-Init command options:
-
-- -f, --force: Overwrite existing starter files.
-- -h, --help: Show help.
-
-## Copy-Paste Examples
-
-Use a custom file and custom output name:
+### Extractor
 
 ```bash
-ff-link-extract -i my-links.txt -o game-links
+node bin/ff_extract_links.js -i urls.txt -o all-direct-links
 ```
 
-Use a paste source URL directly:
+- `--help`
 
 ```bash
-echo "https://paste.fitgirl-repacks.site/?add4fc7178e6fa8f#831kvVZtdGSNdTncYhZ8e2vnks7wuCyYYXHYFeZaWhT3" > paste_source.txt
-ff-link-extract -i paste_source.txt -o game-links
+node bin/ff_extract_links.js --help
 ```
 
-Check installed version:
+- `--version`
 
 ```bash
-ff-link-extract --version
+node bin/ff_extract_links.js --version
 ```
 
-Show help:
+### Autorun
 
 ```bash
-ff-link-extract --help
+node bin/ff_extract_links_autorun.js -c autorun.config.json
 ```
 
-## Updating
+Options:
 
-If using npx:
+- `--interval-ms`
+- `--start-delay-ms`
+- `--max-links`
+- `--dry-run`
 
-- No manual update needed. You get the newest version by default.
-
-If globally installed:
+### Init
 
 ```bash
-npm i -g @hasindu---7/ff-link-extract@latest
+node bin/ff_extract_links_init.js
 ```
 
-## Troubleshooting
+Options:
 
-Problem: command not found after global install on macOS or Linux.
+- `--force`
+- `--help`
 
-Use npx instead:
+## Output Structure
 
-```bash
-npx -y @hasindu---7/ff-link-extract -i urls.txt -o all-direct-links
-```
+Each extractor run creates:
 
-Problem: extraction fails for some links.
+- `links/YYYY-MM-DD_HH-mm-ss/all-direct-links.txt`
+- `links/YYYY-MM-DD_HH-mm-ss/all-direct-links.html`
+- `links/YYYY-MM-DD_HH-mm-ss/all-direct-links.json`
 
-- Check all-direct-links.json for per-link error details.
-- Retry the command after a few minutes.
-- Confirm input actually contains valid fuckingfast page URLs.
+So every run is saved separately and easy to compare.
 
-Problem: no links found in input.
+Autorun behavior:
 
-- Make sure the file includes URLs starting with https://fuckingfast.co/
-- Remove unrelated text if needed and retry.
+- If configured input file is not found in current folder, autorun automatically checks the latest folder inside `links`.
 
-## Local Development
+## Common Checks
 
-Run script directly:
+### Extractor version
 
 ```bash
-node bin/ff_extract_links.js -i urls.txt -o all-direct-links
+node bin/ff_extract_links.js --version
 ```
 
-Test package command locally:
+### If extraction fails for some links
 
-```bash
-npm link
-ff-link-extract -i urls.txt -o all-direct-links
-```
+- Check the generated JSON report for per-link errors.
+- Retry after a short delay.
+
+## npx Method (Optional)
 
-## Package
+If you prefer running without cloning this folder:
 
-- Package: @hasindu---7/ff-link-extract
-- Current bundled files are organized under bin and templates for easier maintenance.
+```bash
+npx -y @hasindu---7/ff-link-extract -i urls.txt -o all-direct-links
+```

package/bin/ff_extract_links.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const fs = require('fs');
 const path = require('path');

package/bin/ff_extract_links_autorun.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const fs = require('fs');
 const path = require('path');

package/bin/ff_extract_links_init.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const fs = require('fs');
 const path = require('path');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasindu---7/ff-link-extract",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Extract direct fuckingfast download links from page URLs",
   "bin": {
     "ff-link-extract": "bin/ff_extract_links.js",