https://github.com/epoupon/fileshelter

FileShelter is a “one-click” file sharing web application
https://github.com/epoupon/fileshelter

file-sharing file-upload raspberry-pi raspberrypi raspbian self-hosted

Last synced: about 1 month ago
JSON representation

FileShelter is a “one-click” file sharing web application

• Host: GitHub
• URL: https://github.com/epoupon/fileshelter
• Owner: epoupon
• License: gpl-3.0
• Created: 2016-06-26T20:19:06.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-03-04T12:52:49.000Z (8 months ago)
• Last Synced: 2024-03-05T14:00:53.544Z (8 months ago)
• Topics: file-sharing, file-upload, raspberry-pi, raspberrypi, raspbian, self-hosted
• Language: C++
• Homepage: https://fileshelter-demo.poupon.dev
• Size: 490 KB
• Stars: 403
• Watchers: 13
• Forks: 34
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

• jimsghstars - epoupon/fileshelter - FileShelter is a “one-click” file sharing web application (C++)

README

        
# FileShelter

[![Last Release](https://img.shields.io/github/v/release/epoupon/fileshelter?logo=github&label=latest)](https://github.com/epoupon/fileshelter/releases)

_FileShelter_ is a self-hosted software that allows you to easily share files over the Internet.

Just upload one or more files and get an URL back!

A [demo](https://fileshelter-demo.poupon.dev) instance is available, with the following limitations:

- Maximum duration is set to 3 days

- Maximum file size is set to 1 MB

## Features

- Period of validity, from one hour to many years

- Optional password protection (download and/or upload)

- Practically unique links, using [UUID](https://fr.wikipedia.org/wiki/Universal_Unique_Identifier)

- Create a zip file on the fly for shares containing multiple files

- Private edit links, used to remove the files or to check the download counters

- Terms Of Service support, fully or partially customizable

- Multiple language support

- Low memory requirements: the demo instance runs on a _Raspberry Pi_

- Command line tools to list and create shares

Once the expiry date is reached, the share is no longer available for download. The files are actually deleted roughly two hours after the share has expired. This is to make sure to not interrupt a download in progress.

## Command line tool

`fileshelter-cmd` is a command line tool with the following features:

* list all the shares available for download.

* create a share using local files. The files are _not_ copied in the _Fileshelter_'s working directory. Therefore the files must still exist while the share is available for download. The files are _not_ deleted once the share has expired.

* destroy shares.

## Installation

See [INSTALL.md](INSTALL.md) file.

## Contributing

Any feedback is welcome:

* feel free to participate in [discussions](https://github.com/epoupon/fileshelter/discussions) if you have questions,

* report any bug or request for new features in the [issue tracker](https://github.com/epoupon/fileshelter/issues),

* submit your pull requests based on the [develop](../../tree/develop) branch.