A file-sharing web app that doesn't suck.
chriskuehl Merge pull request #74 from slingamn/systemrandom
use cryptographically secure randomness for identifiers
Latest commit 9992d10 Nov 16, 2018
Permalink
Failed to load latest commit information.
cli Release cli v1.8.0 Nov 13, 2018
fluffy placate flake8 Nov 15, 2018
playground gitignore some more log directories for new pgctl Jul 11, 2017
settings Provide more useful information in cli when exceeding max file size Nov 22, 2017
testing Add `--direct-link` to fpb and fput Oct 26, 2018
tests Add a `--tee` option for `fpb`. Fixes #67 Oct 27, 2018
vendor Update pre-commit, venv-update, travis config, and other requirements Oct 26, 2018
.activate.sh Fix pre-commit, add aactivator Jul 11, 2016
.coveragerc Fix a couple highlighting edge-cases Sep 20, 2016
.deactivate.sh Fix pre-commit, add aactivator Jul 11, 2016
.dockerignore pyquery is a prod req now Sep 8, 2016
.gitignore Update pre-commit, venv-update, travis config, and other requirements Oct 26, 2018
.pre-commit-config.yaml Update pre-commit, venv-update, travis config, and other requirements Oct 26, 2018
.travis.yml Update pre-commit, venv-update, travis config, and other requirements Oct 26, 2018
CONTRIBUTING.md Build a Debian package for the CLI Jan 20, 2018
Dockerfile Upgrade Docker image to stretch Nov 25, 2017
LICENSE Remove debug backend May 20, 2016
MANIFEST.in Add building/running in Docker May 28, 2016
Makefile Build a Debian package for the CLI Jan 20, 2018
README.md Build a Debian package for the CLI Jan 20, 2018
requirements-dev.txt pre-commit 1.x, autoupdate Nov 22, 2017
requirements.txt Downgrade itsdangerous to 0.24 Oct 26, 2018
setup.cfg Release v1.0.0 Jul 22, 2016
setup.py Downgrade itsdangerous to 0.24 Oct 26, 2018
tox.ini Add pre-commit, Makefile, better packaging May 20, 2016

README.md

fluffy: a file sharing web app that doesn't suck.

Overall build status Build Status Coverage Status
fluffy-server PyPI version
fluffy PyPI version

fluffy screenshots

What is fluffy?

fluffy is a Flask-based web application that allows you to upload arbitrary files to the web. Once you upload the files, you get a link to the file which you can share.

The reference instance of fluffy is online at fluffy.cc. You can also run your own!

What isn't fluffy?

  • fluffy isn't social. Files are given a long, random (unguessable) name. There's no upload feed or list of files.
  • fluffy isn't intrusive. Your files aren't resized, compressed, stripped, or modified in any way.
  • fluffy isn't annoying. A simple, modern page for uploading your files. No ads, no memes, and no comments.

Philosophy and motivation

fluffy was created out of frustration from seeing hundreds of files (mostly images) be lost or deleted over the years from popular image hosts such as imageshack which either deleted files or closed their doors entirely. Fluffy is designed so that it is easy to stop accepting uploads while still serving existing files, with the hope being that a "shut down" would involve no longer accepting uploads, but still continuing to serve existing uploads.

fluffy only handles uploading and storing your files. There's no database, and it's up to you to figure out how you serve the uploaded files. Once fluffy stores a file, it forgets about it.

This not only makes the code simple, but also makes maintenance easy. If you wish to stop accepting uploads, you can easily throw the existing uploads on S3 or any web server to ensure their continued availability.

This does make some features hard or impossible to implement, however, so if you want to do anything post-upload at the application level, fluffy probably isn't for you.

Storing files

fluffy hands off uploaded files to a storage backend, which is responsible for saving the file. The following backends are currently available:

  • File. Storage on the local filesystem. You can easily serve these with any web server.
  • Amazon S3. Storage on Amazon S3. You can serve these with S3 static websites or with CloudFront (if you want a CDN).

Writing a storage backend is dead simple and requires you to implement only a single method. The current backends are both about ten lines of code.

Serving files

fluffy won't serve your files, period. It's up to you to figure this part out. Depending on which backend you use, you may get it easily. For example, Amazon S3 makes it easy to serve uploaded files via the web.

Run your own fluffy

There's a public "reference implementation" of fluffy at fluffy.cc.

To host your own copy of fluffy, just adjust settings.py to your needs, being sure to uncomment whichever storage backend you wish to use. There's no database, so setup is very simple.

Once you've adjusted the configuration, you can deploy fluffy the way you deploy any Flask app. fluffy is tested with Python versions 3.5 and 3.6.

Command-line uploading tools

Two tools, fput and fpb, are provided. They can be installed with pip install fluffy and used from the command line. Use --help with either tool for more information.

Additionally, Debian packages for the command-line tools are available in the GitHub releases tab. These packages contain no binary components and should be compatible with most releases of Debian and Ubuntu.

Contributing, license, and credits

Contributions to fluffy are welcome! Send your pull requests or file an issue. Thanks for the help!

fluffy is released under the MIT license; see LICENSE for full details.

Running locally for development

To run fluffy during development, run make venv and then pgctl start. You should now have fluffy running at http://localhost:5000.

FAQ

Why are there only certain languages in the dropdown? Can I add more?

Since it's just a normal <option> dropdown now, I didn't want to have all hundreds of languages that Pygments supports, as I thought that would make the UI worse for little benefit. Instead, currently there's a hand-picked list of languages that I thought were most popular (but it's definitely biased toward what I use!).

In the long term, I'd love to replace the dropdown with something smarter (maybe a JS dropdown with all the possible languages, featuring the most popular at the top, but with all available below, or with autocomplete or something).

In the medium term, definitely feel free to open an issue or send a PR to add another language. I'll happily merge it.

As a workaround, note that the "automatically detect" can detect languages not in the dropdown (but it's not very accurate much of the time, unfortunately). Additionally, if you use the CLI, you can pass -l <language> and use any language supported by Pygments.

Why are there only a few themes to choose from in the pastebin?

Mostly it's just lack of time to add more. If you have a Pygments theme you like, please open an issue or PR, I'll definitely help get it added.

Primarily the reasons are:

  • There are a lot of Pygments themes and many of them are (imo) low-quality or extremely similar. I thought it was better to hand-curate them and have a small-ish number, rather than a large number where it's hard to find the really good themes.

  • It's not quite as easy as just adding the style name to a list. Fluffy also needs to know colors to use for borders, line numbers, highlights, diff highlights, hover versions of all of these, ANSI color codes that work, etc. There's something like 30 constants to set per theme.

  • With the current implementation, every new theme bloats the CSS a little more. (There's probably a technical solution to this.)

fluffy uses awesome icon sets developed by FatCow and Everaldo Coelho.