12 releases
0.1.11 | Mar 31, 2024 |
---|---|
0.1.10 | Mar 29, 2024 |
0.1.2 | Feb 25, 2024 |
#25 in #file-transfer
664 downloads per month
Used in distrans
160KB
3.5K
SLoC
distrans
"The bytes must flow."
Distrans (distribution and transfer) sends and receives file content anonymously over the Veilid network.
Install
Install binary release
Install a binary release on Linux, macOS or Windows.
Install Rust crate
Install the crate with cargo install distrans
.
Crate dependencies may require system packages to be installed depending on the target platform.
Debian Bookworm needs apt-get install build-essential libssl-dev pkg-config
.
Others may be similar.
Install Nix flake
Run with nix run github:cmars/distrans
.
Add this flake (github:cmars/distrans
) as an input to your home manager flake.
Or add the default package to a legacy home.nix
with something like:
(builtins.getFlake "github:cmars/distrans").packages.x86_64-linux.default
Usage
distrans post <file>
indexes and seeds a file, displaying the dht key where it can be downloaded.
distrans get <dht key> [directory]
downloads a posted file (defaults to current directory).
See distrans --help
for more options.
Try it!
Try fetching a test file with distrans get VLD0:cCHB85pEaV4bvRfywxnd2fRNBScR64UaJC8hoKzyr3M
.
Troubleshooting
Clock skew
Distrans operates an embedded Veilid node, which requires a synchronized local clock. Clock skew can prevent distrans from connecting to the Veilid network.
Debug logging
Logging can be configured with the RUST_LOG environment variable.
RUST_LOG=debug
will enable all debug-level logging in distrans as well as veilid-core, which may be useful for troubleshooting low-level Veilid network problems and reporting issues.
Development
In a Nix environment, nix develop github:cmars/distrans
(or nix develop
in this directory) to get a devshell with the necessary tool dependencies.
On other platforms a Veilid development environment will suffice.
capnp
is only necessary when working on the protocol wire-format.
CICD
Github is used for CICD and especially release automation.
Contributions
Branches and releases are regularly mirrored to Gitlab. Pull requests might be accepted from either, if they fit with the project plans and goals.
Open an issue and ask before picking up a branch and proposing, for best results.
Roadmap
See project plans for short-term plans and contribution ideas.
Long-term: Full duplex peer downloading and uploading. Trackers and swarms.
Dependencies
~25–69MB
~1M SLoC