]> jfr.im git - uguu.git/blame_incremental - README.md
Merge pull request 'Dockerfile for Uguu' (#71) from r4jeshwar/dockerize-uguu into...
[uguu.git] / README.md
... / ...
CommitLineData
1# Uguu
2[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=nokonoko_Uguu&metric=alert_status)](https://sonarcloud.io/dashboard?id=nokonoko_Uguu)
3[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
4[![Documentation Status](https://docs.uguu.se/img/flat.svg)](https://docs.uguu.se)
5
6
7# What is Uguu?
8
9Uguu is a simple lightweight temporary file hosting and sharing platform, but can also be used as a permanent file host.
10
11## Features
12
13- One click uploading, no registration required
14- A minimal, modern web interface
15- Drag & Drop & Paste supported
16- Upload API with multiple response choices
17 - JSON
18 - HTML
19 - Text
20 - CSV
21- Supports [ShareX](https://getsharex.com/) and other screenshot tools
22
23### Demo
24
25See the real world site at [uguu.se](https://uguu.se).
26
27## Requirements
28
29Tested and working with Nginx + PHP-8.0/8.1 + SQLite/MySQL.
30
31Node is used to compile Uguu, after that it runs on PHP.
32
33## Installation
34
35Installation and configuration can be found at [Uguu Documentation](https://docs.uguu.se).
36
37If you need a admin panel check out [Moe Panel](https://github.com/pomf/MoePanel).
38
39## Getting help
40
41Hit me up at [@nekunekus](https://twitter.com/nekunekus) or email me at neku@pomf.se
42
43## Contributing
44
45We'd really like if you can take some time to make sure your coding style is
46consistent with the project. Uguu follows [PHP
47PSR-12](https://www.php-fig.org/psr/psr-12/) and [Airbnb JavaScript
48(ES5)](https://github.com/airbnb/javascript/tree/es5-deprecated/es5) (`airbnb/legacy`)
49coding style guides. We use ESLint and PHPCS tools to enforce these standards.
50
51You can also help by sending us feature requests or writing documentation and
52tests.
53
54## Credits
55
56Uguu is based on [Pomf](http://github.com/pomf/pomf) which was written by Emma Lejack & Eric Johansson (nekunekus) and with help from the open source community.
57
58## License
59
60Uguu is free software, and is released under the terms of the GPL-3.0 license. See
61`LICENSE`.