1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
# README for FUSS
FUSS is a File Upload and Storage Service.
Think [0x0](https://github.com/mia-0/0x0) but without the url shortening. This is intended for private use, such as behind password authentication on the web server level.
## Overview
FUSS runs a web front-end with a little landing page, and some summaries, and you can upload files to the web app. You can download files from it. This project is a demo of the original author's web app skills, and is designed to be relatively bare so you can modify or theme or improve it as you see fit.
## License
GPL 3.0
## How to use
Fuss is a wsgi application. You need some basic python3 packages, and then configure the two config files, which are self-explanatory.
* fuss.conf
* fuss.wsgi.ini
After configuring the files, you can run:
/usr/sbin/fuss.bin
This short script runs uwsgi within xvfb-run, which is necessary if you want to use mimetype icons (loaded through Gtk). If you omit icons, you can omit the xvfb-run part.
You can run this with the included [init script](extras/fuss.init) if you prefer to have a system service.
### Running on certain distros
After installing the package, the admin might need to run a helper script that will install the necessary pip packages. Known situations include:
* CentOS 7: python-flask, python-magic
Run script:
sudo /usr/libexec/fuss/pip-helper.sh
Add the parameter "PyGObject" if you compiled the rpm with icon support (which pulls in a lot of dependencies).
On Fedora, selinux prevents running /var/www/fuss/fuss.bin by systemd.
### Building a distro package
For an rpm, you can generate the correct type of tarball with:
git archive master --format=tar.gz --prefix=fuss/ > ~/rpmbuild/SOURCES/fuss_0.0.2.orig.tar.gz
## Dependencies
* python3-flask
* python3-magic
* For icon support (optional), which just add mimetype icons to the html view of files.
* Xvfb-run
* PyGObject
* python3-gi
## Alternatives
[0x0](https://github.com/mia-0/0x0) or my fork of it, [hex-zero](https://gitlab.com/bgstack15/hex-zero)
## References
### Overall
Heavily inspired by [0x0](https://github.com/mia-0/0x0) or my fork of it, [hex-zero](https://gitlab.com/bgstack15/hex-zero)
### Specific code snippets
* https://code-boxx.com/simple-drag-and-drop-file-upload/
* entire flask series at https://pythonise.com/series/learning-flask/flask-uploading-files
* hex_zero.py from https://gitlab.com/bgstack15/hex-zero
* https://stackoverflow.com/a/65433574/3569534
* https://werkzeug.palletsprojects.com/en/1.0.x/middleware/proxy_fix/
* https://uwsgi-docs.readthedocs.io/en/latest/Logging.html
* Reset stream when reading file from request: https://stackoverflow.com/a/26294982/3569534
* https://salsa.debian.org/sssd-team/sssd/-/blob/experimental/debian/sssd-common.postinst
* /home/var/lib/dpkg/info/postfix.prerm
* bgscripts.spec
* https://docs.fedoraproject.org/en-US/packaging-guidelines/UsersAndGroups/
* https://www.digitalocean.com/community/tutorials/css-collapsible
* viewport in html: https://stackoverflow.com/a/30709473/3569534
* https://www.thesitewizard.com/css/mobile-friendly-responsive-design.shtml
* https://www.dotnettricks.com/learn/stylesheet/css-to-force-long-text-and-urls-to-wrap-on-all-browser
* From https://stackoverflow.com/a/14226807/3569534
|
