Metadata-Version: 2.4
Name: tg-send-cli
Version: 1.0.0
Summary: Send files to Telegram contacts from your CLI
Project-URL: Homepage, https://github.com/ConstantineB6/tg-send-cli
Project-URL: Repository, https://github.com/ConstantineB6/tg-send-cli
Project-URL: Issues, https://github.com/ConstantineB6/tg-send-cli/issues
Author-email: Kostiantyn Bielienko <konstantinbelenko36@gmail.com>
License-Expression: MIT
Keywords: cli,file-sender,file-upload,telegram,tui
Classifier: Development Status :: 4 - Beta
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
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: prompt-toolkit>=3.0
Requires-Dist: rich>=13.0
Requires-Dist: telethon>=1.34
Requires-Dist: thefuzz>=0.22
Description-Content-Type: text/markdown

# 📨 tg-send-cli

Send files to Telegram contacts from your CLI with a pretty TUI.

[![PyPI](https://img.shields.io/pypi/v/tg-send-cli)](https://pypi.org/project/tg-send-cli/)
[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://python.org)

## Features

- **Pretty TUI** — Colors, progress bars, and unicode symbols
- **Fuzzy search** — Find contacts by typing part of their name
- **Easy install** — One command installation

## Installation

```bash
uv tool install tg-send-cli
```

Or with pip:

```bash
pip install tg-send-cli
```

## Setup

Before first use, you need Telegram API credentials:

1. Go to [my.telegram.org](https://my.telegram.org)
2. Log in with your phone number
3. Create a new application
4. Copy your **API ID** and **API Hash**

The tool will prompt you for these on first run.

## Usage

```bash
tgsend photo.jpg        # Send a photo
tgsend document.pdf     # Send a document
tgsend video.mp4        # Send a video
```

### Contact Selection

- **Type** to fuzzy search through contacts
- **↑↓** to navigate
- **Enter** to select
- **Esc** to cancel

### First Run

On first run, you'll be prompted to:
1. Enter your Telegram API credentials
2. Authenticate with your phone number

Your session is saved locally at `~/.telegram_file_sender/`.

## License

MIT
