https://github.com/johnnylearnscs/nekofetch
NekoFetch – A smart, cat-powered CLI scraper for downloading videos, files, and subtitles with optional headless browser support.
https://github.com/johnnylearnscs/nekofetch
automation cli ffmpeg file-downloader headless-browser media-scraper nekofetch playwright python scraper subtitles terminal-app video-downloader
Last synced: 12 months ago
JSON representation
NekoFetch – A smart, cat-powered CLI scraper for downloading videos, files, and subtitles with optional headless browser support.
- Host: GitHub
- URL: https://github.com/johnnylearnscs/nekofetch
- Owner: JohnnyLearnsCS
- License: mit
- Created: 2025-07-17T22:44:03.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-18T01:50:42.000Z (12 months ago)
- Last Synced: 2025-07-18T03:38:08.650Z (12 months ago)
- Topics: automation, cli, ffmpeg, file-downloader, headless-browser, media-scraper, nekofetch, playwright, python, scraper, subtitles, terminal-app, video-downloader
- Homepage:
- Size: 10.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐾 NekoFetch - File & Video Scraper CLI
NekoFetch is a terminal-based intelligent file and media scraper that lets users search, find, and optionally download documents, media, and files across the internet.
Supports: `.pdf`, `.zip`, `.mkv`, `.mp4`, `.mp3`, `.jpg`, `.png`, subtitles, and more.
---
## 🚀 Features
- 🔍 Simple CLI Interface
- 🧠 Guided prompts with optional `--advanced` mode
- 🎯 Filter by type: `--pdf`, `--zip`, `--audio`, `--video`, etc.
- 📁 Queue system for downloading, viewing, and tracking
- 📡 Uses Presearch, DuckDuckGo, and decentralized [SearxNG](https://searx.space/) instances
- ⚠️ Built-in virus warning prompt (requires `--agree`)
- 🧪 Experimental support for `.onion` links (Advanced mode only)
- 💬 Supports subtitle downloads for videos (with language filter)
- 📦 Auto-installs dependencies with progress bar
---
## 🛠 Installation
### Option 1: Python Package
```bash
pip install --user .
```
Then run it anywhere with:
```bash
neko
```
### Option 2: Easy Shell Installer
```bash
git clone https://github.com/JohnnyLearnsCS/nekofetch.git
cd nekofetch
bash install.sh
```
Run with:
```bash
neko
```
---
## 🧪 Advanced Mode
```bash
neko --advanced
```
Advanced mode disables safety rails and lets you:
- Customize your search engine
- Access `.onion` domains (Tor proxy/router required)
- Change scraping depth, headers, and rules
- Run direct links or advanced queries
---
## ⚠️ Safety Disclaimer
NekoFetch **does not verify** file contents.
> You **must** type `--agree` to confirm you're aware files may be harmful.
> Type `--disagree` to cancel and exit.
---
## 🌐 .onion / Tor Usage
If you want to search `.onion` domains:
- You must run in `--advanced` mode
- You need to route traffic through [Tor](https://www.torproject.org/)
- This feature is disabled by default for safety
📖 [Tor Setup Guide (External)](https://tb-manual.torproject.org/)
---
## 🧷 Topics
- `cli`
- `scraper`
- `downloader`
- `file-search`
- `pdf`
- `video`
- `tor`
- `open-source`
- `python3`
- `terminal-tool`
---
## 📜 License
[MIT License](LICENSE)
---
> NekoFetch is a personal experiment in open-source tooling and safe scraping. Not responsible for misuse.