televault 0.1.0__tar.gz

televault-0.1.0/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: televault
+Version: 0.1.0
+Summary: Unlimited cloud storage using Telegram MTProto. No local DB - everything on Telegram.
+Project-URL: Homepage, https://github.com/YahyaToubali/televault
+Project-URL: Repository, https://github.com/YahyaToubali/televault
+Author-email: Yahya Toubali <contact@yahyatoubali.me>
+License: MIT
+Keywords: backup,cloud,mtproto,storage,telegram
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Archiving :: Backup
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=23.2.0
+Requires-Dist: blake3>=0.4.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: telethon>=1.36.0
+Requires-Dist: textual>=0.47.0
+Requires-Dist: zstandard>=0.22.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.2.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# TeleVault
+
+Unlimited cloud storage using Telegram MTProto. No local database — everything lives on Telegram.
+
+## Features
+
+- **MTProto Direct** — No bot API limits, 2GB file support
+- **Zero Local DB** — Metadata stored on Telegram itself
+- **Client-Side Encryption** — AES-256-GCM before upload
+- **Smart Chunking** — Large files split automatically
+- **Parallel Processing** — Faster uploads/downloads
+- **Folder Support** — Preserve directory structure
+- **Resume Capability** - Continue interrupted transfers
+- **TUI + CLI** - Beautiful terminal interface
+
+## Install
+
+```bash
+pip install televault
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/YahyaToubali/televault
+cd televault
+pip install -e .".
+```
+
+## Quick Start
+
+```bash
+# First time: authenticate with Telegram
+televault login
+
+# Upload a file
+televault push backup.tar.gz
+
+# Upload a directory
+televault push ~/Documents/ -r --no-encrypt
+
+# List files
+televault ls
+
+# Download
+televault pull backup.tar.gz
+
+# Interactive TUI
+televault
+```
+
+## How It Works
+
+```
+Your File
+    ↓
+[Compress] → zstd (optional, skips media)
+    ↓
+[Encrypt] → AES-256-GCM with Scrypt key derivation
+    ↓
+[Chunk] → Split into ≤2GB pieces
+    ↓
+[Upload] → MTProto to your private channel
+    ↓
+[Index] → Metadata stored as pinned message
+```
+
+### Channel Structure
+
+```
+📌 INDEX (pinned)
+│   └── {"files": {"id1": msg_id, "id2": msg_id, ...}}
+│
+├── 📄 Metadata Message (JSON)
+│   └── {"name": "file.zip", "size": 5GB, "chunks": [...]}
+│
+└── 📦 Chunk Messages (reply to metadata)
+    └── file_id_001.chunk, file_id_002.chunk, ...
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `televault login` | Authenticate with Telegram |
+| `televault logout` | Clear session |
+| `televault push <file>` | Upload file (or directory with -r) |
+| `televault pull <file>` | Download file |
+| `televault ls` | List all files |
+| `televault search <query>` | Search files by name |
+| `televault rm <file>` | Delete file |
+| `televault info <file>` | Show file details |
+| `televault status` | Show vault status |
+| `televault whoami` | Show current Telegram account |
+| `televault` | Launch TUI |
+
+## Configuration
+
+Config stored at `~/.config/televault/config.json`:
+
+```json
+{
+  "channel_id": -1003652003243,
+  "chunk_size": 104857600,
+  "compression": true,
+  "encryption": true,
+  "parallel_uploads": 3,
+  "parallel_downloads": 5,
+  "max_retries": 3,
+  "retry_delay": 1.0
+}
+```
+
+## Security
+
+- **Encryption**: AES-256-GCM (authenticated encryption)
+- **Key Derivation**: Scrypt (memory-hard, GPU-resistant)
+- **Session**: Telegram MTProto session stored encrypted
+- **Zero Knowledge**: Server never sees unencrypted data
+- **MTProto**: Direct Telegram protocol (no bot API limits)
+
+## Prerequisites
+
+- Telegram API credentials (get at [my.telegram.org](https://my.telegram.org))
+- Telegram account
+- Python 3.11+
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install televault
+```
+
+### From Source
+
+```bash
+git clone https://github.com/YahyaToubali/televault
+cd televault
+pip install -e .".
+```
+
+## Setup
+
+```bash
+# Authenticate with Telegram
+televault login
+
+# Set up storage channel
+televault setup
+
+# Upload your first file
+televault push hello.txt
+```
+
+## Usage Examples
+
+### Upload a file
+```bash
+televault push backup.tar.gz --password mysecret
+```
+
+### Upload a directory
+```bash
+televault push ~/Documents/ -r --no-encrypt
+```
+
+### Download a file
+```bash
+televault pull backup.tar.gz --password mysecret
+```
+
+### List files
+```bash
+televault ls --sort=size
+```
+
+### Search files
+```bash
+televault search "*.sql"
+```
+
+## TUI
+
+Launch the interactive terminal interface:
+
+```bash
+televault
+```
+
+Controls:
+- `r` = Refresh
+- `u` = Upload
+- `d` = Download selected
+- `q` = Quit
+- Arrow keys to navigate
+
+## License
+
+MIT
+
+## Author
+
+Yahya Toubali - [@yahyatoubali](https://github.com/YahyaToubali)
+
+---
+
+Built with ❤️ using Python, Telethon, and Textual

televault-0.1.0/README.md

@@ -0,0 +1,209 @@
+# TeleVault
+
+Unlimited cloud storage using Telegram MTProto. No local database — everything lives on Telegram.
+
+## Features
+
+- **MTProto Direct** — No bot API limits, 2GB file support
+- **Zero Local DB** — Metadata stored on Telegram itself
+- **Client-Side Encryption** — AES-256-GCM before upload
+- **Smart Chunking** — Large files split automatically
+- **Parallel Processing** — Faster uploads/downloads
+- **Folder Support** — Preserve directory structure
+- **Resume Capability** - Continue interrupted transfers
+- **TUI + CLI** - Beautiful terminal interface
+
+## Install
+
+```bash
+pip install televault
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/YahyaToubali/televault
+cd televault
+pip install -e .".
+```
+
+## Quick Start
+
+```bash
+# First time: authenticate with Telegram
+televault login
+
+# Upload a file
+televault push backup.tar.gz
+
+# Upload a directory
+televault push ~/Documents/ -r --no-encrypt
+
+# List files
+televault ls
+
+# Download
+televault pull backup.tar.gz
+
+# Interactive TUI
+televault
+```
+
+## How It Works
+
+```
+Your File
+    ↓
+[Compress] → zstd (optional, skips media)
+    ↓
+[Encrypt] → AES-256-GCM with Scrypt key derivation
+    ↓
+[Chunk] → Split into ≤2GB pieces
+    ↓
+[Upload] → MTProto to your private channel
+    ↓
+[Index] → Metadata stored as pinned message
+```
+
+### Channel Structure
+
+```
+📌 INDEX (pinned)
+│   └── {"files": {"id1": msg_id, "id2": msg_id, ...}}
+│
+├── 📄 Metadata Message (JSON)
+│   └── {"name": "file.zip", "size": 5GB, "chunks": [...]}
+│
+└── 📦 Chunk Messages (reply to metadata)
+    └── file_id_001.chunk, file_id_002.chunk, ...
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `televault login` | Authenticate with Telegram |
+| `televault logout` | Clear session |
+| `televault push <file>` | Upload file (or directory with -r) |
+| `televault pull <file>` | Download file |
+| `televault ls` | List all files |
+| `televault search <query>` | Search files by name |
+| `televault rm <file>` | Delete file |
+| `televault info <file>` | Show file details |
+| `televault status` | Show vault status |
+| `televault whoami` | Show current Telegram account |
+| `televault` | Launch TUI |
+
+## Configuration
+
+Config stored at `~/.config/televault/config.json`:
+
+```json
+{
+  "channel_id": -1003652003243,
+  "chunk_size": 104857600,
+  "compression": true,
+  "encryption": true,
+  "parallel_uploads": 3,
+  "parallel_downloads": 5,
+  "max_retries": 3,
+  "retry_delay": 1.0
+}
+```
+
+## Security
+
+- **Encryption**: AES-256-GCM (authenticated encryption)
+- **Key Derivation**: Scrypt (memory-hard, GPU-resistant)
+- **Session**: Telegram MTProto session stored encrypted
+- **Zero Knowledge**: Server never sees unencrypted data
+- **MTProto**: Direct Telegram protocol (no bot API limits)
+
+## Prerequisites
+
+- Telegram API credentials (get at [my.telegram.org](https://my.telegram.org))
+- Telegram account
+- Python 3.11+
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install televault
+```
+
+### From Source
+
+```bash
+git clone https://github.com/YahyaToubali/televault
+cd televault
+pip install -e .".
+```
+
+## Setup
+
+```bash
+# Authenticate with Telegram
+televault login
+
+# Set up storage channel
+televault setup
+
+# Upload your first file
+televault push hello.txt
+```
+
+## Usage Examples
+
+### Upload a file
+```bash
+televault push backup.tar.gz --password mysecret
+```
+
+### Upload a directory
+```bash
+televault push ~/Documents/ -r --no-encrypt
+```
+
+### Download a file
+```bash
+televault pull backup.tar.gz --password mysecret
+```
+
+### List files
+```bash
+televault ls --sort=size
+```
+
+### Search files
+```bash
+televault search "*.sql"
+```
+
+## TUI
+
+Launch the interactive terminal interface:
+
+```bash
+televault
+```
+
+Controls:
+- `r` = Refresh
+- `u` = Upload
+- `d` = Download selected
+- `q` = Quit
+- Arrow keys to navigate
+
+## License
+
+MIT
+
+## Author
+
+Yahya Toubali - [@yahyatoubali](https://github.com/YahyaToubali)
+
+---
+
+Built with ❤️ using Python, Telethon, and Textual

televault-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[project]
+name = "televault"
+version = "0.1.0"
+description = "Unlimited cloud storage using Telegram MTProto. No local DB - everything on Telegram."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "Yahya Toubali", email = "contact@yahyatoubali.me" }]
+keywords = ["telegram", "storage", "cloud", "mtproto", "backup"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Archiving :: Backup",
+]
+
+dependencies = [
+    "telethon>=1.36.0",
+    "cryptography>=42.0.0",
+    "zstandard>=0.22.0",
+    "blake3>=0.4.0",
+    "textual>=0.47.0",
+    "click>=8.1.0",
+    "rich>=13.7.0",
+    "aiofiles>=23.2.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "ruff>=0.2.0",
+    "mypy>=1.8.0",
+]
+
+[project.scripts]
+televault = "televault.cli:main"
+tv = "televault.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/YahyaToubali/televault"
+Repository = "https://github.com/YahyaToubali/televault"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/televault"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP", "B", "C4", "SIM"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

televault-0.1.0/src/televault/__init__.py

@@ -0,0 +1,16 @@
+"""
+TeleVault - Unlimited cloud storage using Telegram MTProto.
+
+Features:
+- MTProto Direct (no bot API limits)
+- Zero Local DB (metadata on Telegram)
+- Client-side Encryption (AES-256-GCM)
+- Parallel Processing
+- Folder Support
+- TUI + CLI
+"""
+__version__ = "1.0.0"
+__author__ = "Yahya Toubali"
+__email__ = "yahya@yahyatoubali.me"
+__license__ = "MIT"
+__url__ = "https://github.com/yahyatoubali/televault"