FTS is a lightweight CLI tool and TUI application for fast local-network file transfers and communication. Key features include:
- LAN chat
- Contacts & online users
- Intuitive file transfers with progress display
- Transfer history tracking
- Encrypted file transfers
FTS is designed for local networks and should never be used on public networks without permission.
Check out the Documentation for installation and usage guides.
FTS leverages Textual for a sleek, intuitive TUI and uses a custom logger for clean CLI output.
- Python 3.9 or higher
- Network access for LAN transfers
Warning
Python must be installed and correctly added to your system PATH to run fts directly from the terminal.
Install FTS globally using pip:
python -m pip install fts-toolStart a server to receive files in Downloads/fts with a progress bar:
fts open Downloads/fts --progressSend a file to a running server (replace 127.0.0.1 with the target IP):
fts send "C:\Users\You\Desktop\project.zip" 127.0.0.1 --progressNote
The server must be running and discoverable on the LAN to receive files.
Run the FTS App interface (TUI) without any arguments:
ftsFrom here you can:
- Chat with other users on the local network
- Send and receive files through an intuitive visual interface
- View online users and manage contacts
- Review past transfers in the history panel
Note
A machine must have the App running to be discoverable by other users on the LAN.
FTS development remains active, and future updates will be released. All issues and pull requests will be addressed promptly.
Pull requests are welcome! For major changes, please open an issue first to discuss your proposed modifications.
- Submit PRs against the
mainbranch. - Follow existing code style and conventions.
- Include tests or examples when possible.
- Respect the Code of Conduct.
- Please do not run FTS on public networks without proper authorization.
- FTS is intended for LAN environments only.