Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mdouchement/fichenn
Fichenn is a standalone binary - written in Golang - for uploading and downloading secured files.
https://github.com/mdouchement/fichenn
file finn sharing-platform storage
Last synced: about 1 month ago
JSON representation
Fichenn is a standalone binary - written in Golang - for uploading and downloading secured files.
- Host: GitHub
- URL: https://github.com/mdouchement/fichenn
- Owner: mdouchement
- License: mit
- Created: 2020-06-07T10:42:25.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-12-29T12:17:56.000Z (12 months ago)
- Last Synced: 2024-06-20T10:17:43.425Z (6 months ago)
- Topics: file, finn, sharing-platform, storage
- Language: Go
- Homepage:
- Size: 156 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Fichenn
Fichenn is a standalone binary - written in Golang - for uploading and downloading secured files.
It aims to be portable and have a straightforward stream implementation (no fancy customisation based on third libraries like cURL and OpenSSL). The drawback is that you need to install this binary on both source and destination operating system.
## Usage
```
[~]>> finn -h
Fichenn secured uploads
Usage:
finn [flags]
Flags:
-c, --chmod+x perform `chmod +x' on downloaded file
-x, --extract Tarball extract
-h, --help help for finn
-o, --output string write output to given destination
-p, --pass string passphrase used to decrypt
-v, --version version for finn
```
```
[~]>> finn ~/.fichennrc
Passphrase: nF1wCZ8nHv(in|GqaVkWq~iw
⠸ uploading (276 B, 0.716 kB/s)
Command:
finn --pass "nF1wCZ8nHv(in|GqaVkWq~iw" "https://plik.root.gg/file/dfhJOmsP6xOpMnPG/SjJA2l1ZA6kOxizn/.fichennrc" -o ".fichennrc"
Copied to the clipboard
```
```
[~]>> finn ~/.vim
Passphrase: G8iORZz4pMU=O4i#6cGEJ~ci
⠼ uploading (8.1 MB, 1.109 MB/s)
Command:
finn --pass "G8iORZz4pMU=O4i#6cGEJ~ci" "https://plik.root.gg/file/6HRYSfIZH7uiPAjn/IZYdbDFJe4HtxH9p/.vim.tar" -o ".vim.tar" --extract
Copied to the clipboard
```
### Web Finn
This service does the same actions as the CLI but in WASM, in the web browser.
This service have to proxify all the traffic to the datastore in order to comply with web browsers security.
> The data upload and downloaded are not readable by the proxy since it's encrypted/decrypted in the web browser.
## How does it work?
- Upload stream workflow
```
file -> zstd -> age-encryption.org/v1 -> storage-server
```
```
directory -> tarball -> zstd -> age-encryption.org/v1 -> storage-server
```
- Download stream workflow
```
storage-server -> age-encryption.org/v1 -> zstd -> file
```
```
storage-server -> age-encryption.org/v1 -> zstd -> tarball -> directory
```
> - Compressed with Zstandard algorithm
> - Stream chunked encryption scheme with [age](https://github.com/FiloSottile/age)
## Storages
- [Plik](https://plik.root.gg/) (https://github.com/root-gg/plik)
## License
**MIT**
## Contributing
All PRs are welcome.
1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin my-new-feature)
6. Create new Pull Request