mtp-manager

Minimal terminal UI for managing telemt on Debian, Ubuntu, Fedora, and Arch Linux

Overview

mtp-manager is a lightweight TUI for installing, configuring, and operating a telemt-based MTProto proxy with Fake TLS support. It is designed for small VPS setups where a compact workflow matters more than a large control panel.

Highlights

• install and update telemt
• install a specific tag or commit
• manage users and secrets
• export raw, dd, and ee links
• inspect service status and logs
• run cleanup tasks for logs, cache, and runtime artifacts
• switch the interface between English, Russian, and Chinese

Request Flow

The diagram below shows the high-level path of an MTProto message when telemt is used as the proxy layer with Fake TLS enabled.

Installation

From PyPI

Install the latest published version from PyPI:

python3 -m pip install mtp-manager

Run the application:

mtp-manager

mtp-manager performs system-level operations such as service management, firewall updates, and cleanup tasks, so it is typically expected to run with root privileges.

From source

Clone the repository and use the bootstrap script:

source setup.sh
mtp-manager

setup.sh is meant to be sourced from bash or zsh. It prepares .venv, installs the project in editable mode, validates the entrypoint, and activates the environment in the current shell.

Requirements

• Python 3.11+
• Debian, Ubuntu, Fedora, or Arch Linux
• systemd
• root privileges for install, service, firewall, and cleanup operations

Project Layout

Managed Paths

Notes

• shell execution is routed through the infra layer
• generated files are written atomically
• managed systemd units invoke the installed mtp-manager entrypoint
• migration logic for older mtproxy layouts is included