About farisc0de/Uploady

Simple File Uploading Software

f

Published by

farisc0de

Visit View Profile

README.md

View on GitHub

Uploady

Uploady is a modern, secure file uploader script with multi-file upload support.

It comes with more than 20 features and you can set it up in less than 5 minutes.

Built with PHP 8.x and MySQL, featuring a modern Bootstrap 5.3 UI.

Free and open source under the MIT license.

Features

Multi-File Upload - Drag and drop support with progress tracking
5 Protection Levels
- MIME type validation
- Extension whitelist
- File size limits (role-based)
- Forbidden filename blocking
- ClamAV virus scanning (optional)
Admin Panel - Charts, stats, and complete file management
Role-based Access - User roles with configurable upload size limits
Data Collection - IP address, browser, OS, and country detection
Localization - Multi-language support with RTL compatibility
Customization - Custom CSS/JS, logo, favicon, AdSense, and Google Analytics
File Management - Auto-delete after X days or X downloads
Pages System - Create and manage custom pages
Report Abuse - Built-in abuse reporting system
Social Sharing - Share uploaded files on social media
API Access - RESTful API with API key authentication

Project Structure

uploady/
├── actions/           # AJAX action handlers (upload, delete, etc.)
├── admin/             # Admin panel pages and settings
├── api/               # REST API endpoints
├── assets/            # CSS, JS, and static assets
├── components/        # Reusable PHP components
├── config/            # Configuration files
├── languages/         # Language translation files
├── logic/             # Business logic handlers
├── modules/           # Feature modules
├── profile/           # User profile pages
├── src/Uploady/       # Core application classes
│   ├── Handler/       # Upload and file handlers
│   ├── Auth.php       # Authentication
│   ├── Database.php   # Database wrapper
│   ├── Mailer.php     # Email functionality
│   ├── Role.php       # Role management
│   ├── Settings.php   # Application settings
│   ├── User.php       # User management
│   └── Utils.php      # Utility functions
├── uploads/           # User uploaded files
└── vendor/            # Composer dependencies

Screenshots

Requirements

PHP 8.0 or higher
MySQL 5.7 or higher
Composer
Required PHP extensions: pdo, pdo_mysql, gd, fileinfo, json, mbstring
Optional: ClamAV for virus scanning

Installation

Standard Installation

Upload all files to your server
Run composer install in the uploady/ directory
Modify config/config.php with your database credentials:

define("DB_HOST", "localhost");
define("DB_USER", "your_username");
define("DB_PASS", "your_password");
define("DB_NAME", "uploady");
define("SITE_URL", "https://yourdomain.com/");

Set directory permissions:

chmod 755 -R uploady/
chmod 775 uploady/uploads/
chmod 775 uploady/storage/

Navigate to install.php in your browser
Follow the installation wizard
Delete install.php after successful installation

Docker Deployment

Clone the repository:

git clone https://github.com/farisc0de/Uploady
cd Uploady/

Update config/config.php for Docker:

define("DB_HOST", "db");
define("DB_USER", "uploady");
define("DB_PASS", "uploady");
define("DB_NAME", "uploady");

Build and run:

docker-compose up -d

ClamAV Integration (Optional)

Uploady supports ClamAV for real-time virus scanning of uploaded files.

Installing ClamAV

Ubuntu/Debian:

sudo apt update
sudo apt install clamav clamav-daemon
sudo systemctl start clamav-daemon
sudo systemctl enable clamav-daemon

CentOS/RHEL:

sudo yum install epel-release
sudo yum install clamav clamav-update clamd
sudo systemctl start clamd@scan
sudo systemctl enable clamd@scan

macOS (Homebrew):

brew install clamav
cp /usr/local/etc/clamav/freshclam.conf.sample /usr/local/etc/clamav/freshclam.conf
cp /usr/local/etc/clamav/clamd.conf.sample /usr/local/etc/clamav/clamd.conf
freshclam
clamd

Update Virus Definitions

sudo freshclam

Configure Uploady for ClamAV

In your admin panel, enable the "Virus Scanner" option.

Verify ClamAV is Running

# Check socket exists
ls -la /var/run/clamav/clamd.sock

# Test ClamAV
echo "X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*" | clamdscan -

API Usage

Upload a File

curl --location 'https://yourdomain.com/api/upload' \
--header 'X-API-KEY: your_api_key_here' \
--form 'file=@"/path/to/your/file.jpg"'

Response

{
  "filename": "original_name.jpg",
  "filehash": "hashed_filename.jpg",
  "filesize": "1.5 MB",
  "uploaddate": "2025-01-23 12:00:00",
  "fileurl": "https://yourdomain.com/uploads/user_id/hashed_filename.jpg",
  "filetype": "image/jpeg",
  "file_id": "abc123...",
  "user_id": "xyz789..."
}

Wiki

Roadmap (v4.0)

[x] PhpFileUpload refactor
[x] Upgrade Bootstrap to 5.3.3
[x] Modernize the UI
[x] ClamAV malware scanning support
[ ] Report abuse dashboard
[ ] S3 Bucket integration (PhpFileUploading supports it, but not implemented yet in Uploady)
[ ] File tagging system (In Progress)
[ ] Short URL generation (In Progress)
[ ] File preview (PDF, video, audio players)
[ ] File comments/notes
[ ] Email file sharing

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.

Copyright

Developed by Faris AL-Otaibi - 2024-2025

farisc0de/Uploady