Skip to main content

Simple and secure file transfer CLI

Project description

Bestow

Simple and secure file transfer CLI.

Codeberg CPython 3.10+ PyPI Version AGPLv3+ License

Table of Contents

Description

This Python program facilitates fast encrypted file transfers over a TCP connection. I made this project because I needed peace of mind when sending data on an untrusted network.

Features

  • Straightforward command-line interface.
  • Secured with modern encryption standards.
  • Capable of handling large files efficiently.
  • Speed benefits due to asynchronous design.
  • Supports multiple client connections concurrently.

Installation

This project supports CPython v3.10 and later. The latest version can be installed at https://python.org/download/.

Using uv

This is the recommended installation method because it isolates the package environment from the system.

  1. Install uv if you haven't already:
python3 -m pip install --user uv
uv tool update-shell
  1. Install the package:
uv tool install bestow
  1. Update the package:
uv tool upgrade bestow

Make sure to restart the shell before using bestow.

Using pip

:warning: This installation method is not recommended, as the package will be installled in the global environment. This is not ideal because it can lead to dependency conflicts or potentially break packages needed by the system.

python3 -m pip install bestow

Using Termux

If you have issues with the recommended install method on Termux, you can build PyNaCl using the system installation of libsodium. The solution is was taken from a PyNaCl GitHub issue.

pkg install clang python libffi openssl libsodium
SODIUM_INSTALL=system python -m pip install pynacl
python3 install bestow

Usage

The file transfer model involves two components: the server, who provides the file, and the client, who receives the file. This model ensures that the server can control who will receive the data and helps to mitigate malicious actors.

Sending a File

This will make it possible for a client to connect to the server's IP address on a specific port (by default it is 50222).

bestow start file.txt

Receiving a File

bestow connect 192.168.0.1

License

This project is licensed under the GNU Affero General Public License version 3.0 or later. See the LICENSE file for more details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bestow-0.1.3.tar.gz (31.0 kB view details)

Uploaded Source

File details

Details for the file bestow-0.1.3.tar.gz.

File metadata

  • Download URL: bestow-0.1.3.tar.gz
  • Upload date:
  • Size: 31.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.4.16

File hashes

Hashes for bestow-0.1.3.tar.gz
Algorithm Hash digest
SHA256 8f27c3e0805cd460a587e03987ea4c200038b4c646a4f067c4e3c671ffeff910
MD5 4a5a6d2fd228be6eb47d30f9f5842412
BLAKE2b-256 4fcaa876af1a978d8ec7ba037c1e8351a079b594390303140a20347be70ae294

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page