☆ DownSrc ☆

"I just want to download my stuff ugh.."

Start Using • Documentation • Versions • Credits

A simple, cute command-line tool for downloading files and websites.

☆-Features

• Download single files or entire webpages with the resources intact!
• Deep scraping - Follow same-domain links recursively
• File extension filtering - Download only specific file types
• Colorful terminal interface with progress bars
• Multiple download flags and options
• Zip downloaded files automatically
• Generate HTML reports
• Custom actions for automation
• Configurable settings
• Funny commands cat, sheep, bee

☆-Installation

npm install -g @everm4iva/downsrc

☆-Start using it!

# Download a file
downsrc https://example.com/file.zip

# Download a webpage with all resources (just that page)
downsrc https://example.com/page.html

# Download and zip
downsrc -z https://example.com/website

# Download with quality report
downsrc --dr https://example.com/files

# Download only specific file types
downsrc --fe "png & jpg" https://example.com/gallery

# Advanced scraping - follow 5 links on same domain
downsrc --as 5 https://example.com/website

# Combine filters: scrape 3 links, only download PDFs
downsrc --as 3 --fe pdf https://example.com/docs

# Check if link is accessible
downsrc -c https://example.com/file.zip

# Check security/certificates
downsrc -v https://example.com

☆-Available Commands

Basic Usage

• downsrc <url> - Download from URL
• downsrc help - Show help with examples
• downsrc details - Show package information
• downsrc cat - Display cat symbol

Settings

• downsrc set <var> <value> - Change configuration
• downsrc action add <name> <command> - Add custom action
• downsrc action remove <name> - Remove action
• downsrc action list - List all actions
• downsrc run <action> - Run custom action

Flags

Download Options

• -o - Open file after download
• -z - Zip files after download
• -p <path> - Specify download path
• --tl <seconds> - Set time limit
• --ms <mb> - Maximum file size (skip)
• --mss <mb> - Maximum file size (pause and ask)
• --fe <extensions> - Filter by file extension (e.g., png & jpg & webp)
• --as <number> - Advanced scraping - follow N links from the page (same-domain links)

Reports and UI

• --hr - Generate HTML report
• --hh - Host interactive HTML UI in browser
• --dr - Show download quality report
• -d - Include debug.txt in zip

Checking

• -c - Check link accessibility
• -v - Check vulnerabilities/security

Automation

• -y - Yes to all prompts
• -n - No to all prompts
• --debug-on - Enable debug mode
• --debug-off - Disable debug mode

☆-Documentation

For now.. none, keep exploring on ur own

Documentation is available in the docs folder:

• Getting Started
• Flags Reference
• Configuration
• Actions
• Examples

☆-Examples

Download and open a file

downsrc -o https://example.com/document.pdf

Download website with time limit

downsrc --tl 60 https://example.com/website

Download only specific file types

# Download only PNG images
downsrc --fe png https://example.com/gallery
# Download multiple image formats
downsrc --fe "png & jpg & webp" https://example.com/gallery

Advanced scraping - follow links

# Follow and download up to 5 links from the page
downsrc --as 5 https://example.com
# Follow all links (prompts if more than 10)
downsrc --as https://example.com
# Download page and follow up to 3 same-domain links
downsrc -as 3 https://example.com/website
# Download page and follow all same-domain links (will prompt if >10)
downsrc -as https://example.com/website
# Download only the page and resources (root-num = 0)
downsrc -as 0 https://example.com/page

File extension filtering

# Download only PNG images
downsrc -fe png https://example.com/gallery
# Download multiple file types
downsrc -fe "png & jpg & webp & svg" https://example.com/images
# Combine with advanced scraping
downsrc -as 5 -fe "pdf & docx" https://example.com/documents

Complete workflow

downsrc -z --hr --dr -p ./downloads https://example.com/project

Create and run custom action

downsrc action add backup "tar -czf backup.tar.gz ./downloads"
downsrc run backup

☆-Configuration

Settings configuration

Settings are stored in resources/coolshits.json:

{
    "accentColor": "orange",
    "defaultDownloadDir": "./downloads",
    "maxConcurrentDownloads": 3,
    "defaultZipAfterDownload": false
}

Change settings via command line:

downsrc set maxConcurrentDownloads 5
downsrc set defaultZipAfterDownload true

☆-Architecture

• Pure JavaScript (no TypeScript or frameworks)
• Modular and configurable design
• All variables in coolshits.json
• Custom actions in actions.json
• Simple symbols instead of emoji (»*+-#$!)
• Orange accent color theme

☆-Project Structure

downsrc/
├── bin/
│   └── downsrc.js          # CLI entry point
├── resources/
│   ├── index.js            # Main module
│   ├── logic.js            # Download logic
│   ├── terminal-wowies.js  # Terminal UI
│   ├── fs.js               # File operations
│   ├── settings.js         # Configuration
│   ├── debugger.js         # Logging system
│   ├── server.js           # Web UI server
│   ├── coolshits.json      # Settings file
│   ├── actions.json        # Custom actions
│   ├── commands/           # Command handlers
│   │   ├── zipper.js
│   │   ├── htmlgen.js
│   │   ├── report.js
│   │   ├── check-vul.js
│   │   ├── timelimit.js
│   │   └── actions.js
│   └── symbols/
│       └── cat.txt
├── docs/                   # Documentation
└── package.json

☆-Dependencies

Big help! thank u so much

• minimist - Argument parsing
• chalk - Terminal colors
• cli-progress - Progress bars
• archiver - Zip creation
• cheerio - HTML parsing
• p-limit - Concurrency control
• prompts - User input
• open - Open files

☆-Contributing

Free to do something. in fact.. free to do anything, did u read the LICENSE file??

☆-Author - everm4iva (m4iva)