README.md

   1 # Uguu
   2
   3 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=nokonoko_Uguu&metric=alert_status)](https://sonarcloud.io/dashboard?id=nokonoko_Uguu)
   4 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
   5 [![Documentation Status](https://docs.uguu.se/img/flat.svg)](https://docs.uguu.se)
   6
   7 # What is Uguu?
   8
   9 Uguu 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 - File extension & MIME black/whitelisting.
  23 - Upload rate limiting.
  24 - File (hash) blacklisting.
  25 - Run bare or as a container.
  26
  27 ### Demo
  28
  29 See the real world site at [uguu.se](https://uguu.se).
  30
  31 ## Requirements
  32
  33 Tested and working with Nginx + PHP-8.1 + SQLite/MySQL/PostgreSQL.
  34
  35 Node is used to compile Uguu, after that it runs on PHP.
  36
  37 ## Installation
  38
  39 Installation and configuration can be found at [Uguu Documentation](https://docs.uguu.se).
  40
  41 If you need a admin panel check out [Moe Panel](https://github.com/Pomf/MoePanel).
  42
  43 ## Getting help
  44
  45 Hit me up at [@nekunekus](https://twitter.com/nekunekus) or email me at neku@pomf.se
  46
  47 ## Contributing
  48
  49 We'd really like if you can take some time to make sure your coding style is
  50 consistent with the project. Uguu follows [PHP
  51 PSR-12](https://www.php-fig.org/psr/psr-12/) and [Airbnb JavaScript
  52 (ES5)](https://github.com/airbnb/javascript/tree/es5-deprecated/es5) (`airbnb/legacy`)
  53 coding style guides. We use ESLint and PHPCS tools to enforce these standards.
  54
  55 You can also help by sending us feature requests or writing documentation and
  56 tests.
  57
  58 ## Upcoming Features
  59
  60 * S3 Bucket Support
  61 * Azure File Storage Support
  62 * Temporal/RR Support
  63
  64 ## Credits
  65
  66 Uguu is based on [Pomf](http://github.com/pomf/pomf) which was written by Emma Lejack & Go Johansson (nekunekus) and with help from the open source community.
  67
  68 ## License
  69
  70 Uguu is free software, and is released under the terms of the GPL-3.0 license. See
  71 `LICENSE`.