🐺 Gray Wolf System – v0.9.7 Beta

A personal file management system built with Flask, featuring audio, video, image players and more — all accessible through a responsive web interface.

---

Table of Contents

• Gray Wolf System
• Project Goals
• How to Use
• Status
• Technologies Used
• Installation Guide
  • Cloning the repository
  • Installing with installer script
• License

---

🐺 Gray Wolf System

is a lightweight web application built with Flask (Python), designed to turn any Linux device (old PC, server, or even a Termux-based Android phone) into a local file server. Main features include:

• File upload and download
• Integrated viewers for images, videos, audio, documents, and text
• Category-based file organization
• Recent uploads preview
• Responsive web interface (HTML + CSS + JS)
• Admin panel and user statistics
• Action logging system
• Simple user management and access control

---

🎯 Project Goals

• Access your files remotely via browser (local IP)
• Organize files by type and category
• Repurpose old devices as personal servers
• Free up mobile storage by offloading files to server
• Provide a simple and clean web interface
• Enable the server to be used as an online backup
• Basic user management (admin / normal user)
• Simple logs and activity history

---

🚀 How to Use

1. Install and run the application on a Linux-based system:

   • PC, laptop, Raspberry Pi, old phone (Termux), or server

2. Run it using Python 3 with Flask installed.

3. Your server's local storage becomes accessible over your local network.

4. Access via browser using your server’s IP or: http://127.0.0.1:7777

---

🚧 Status: Beta v0.9.7

✅ Available Features

• Upload and download files
• Video playback (MP4)
• Image viewer
• Audio player (MP3, WAV)
• Document viewer (PDF, DOC, XLS, PPT)
• Text file viewer (.txt)
• Recently uploaded files list (per user)
• Show files only if public or owned by the user
• Rename files (video, document, text) — keeps owner/public prefix
• File deletion system with size tracking per user
• User registration system (Admin or Regular)
• System logs (user actions, access attempts, uploads)
• Reserved usernames protection
• Logout button (top-right)
• Back button redesigned (top-left icon)
• System Status Page (shows memory & usage; admin-only)
• Installer with admin setup and update mode (no data loss)
• Edit .txt files directly from browser
• Add base rename logic improvements
• Info button to view file metadata
• Enhanced system stats page
• Log Viewer page (linked from admin stats panel)

🛠️ Planned Features (Coming Soon)

• Start development of real-time chat
• File permission system (similar to Linux: read/delete/upload control)
  • Add new "Guest" user level (view-only)
• Per-user storage quota configuration (e.g., 50GB per user from 1TB)
• Edit documents online (DOC/XLS)
  • Investigate possible APIs or JS-based editors (especially for Excel)
• Improve security
  • Basic brute-force protection
  • Optional login persistence or 2FA/email verification
• Better video support (MKV and other formats)
• Add search, filters, and sort by name/date/size
• Admin web terminal (remote control of host machine)
• Trash bin system (soft delete with restore)
• Music player UI for AUDIO >> MUSIC
  • Style similar to YouTube Music or Spotify

---

⚙️ Technologies Used

• Flask (Python)
• HTML + CSS + JavaScript
• Local hosting on Linux / Android (Termux)
• Lightweight and minimal structure

---

🚀 Installation Guide

Cloning the repository

git clone https://github.com/Rian-Batista-Rx4n/GWS
cd GWS
python3 main.py

🔽 Download Installers

• 🇺🇸 install_EN.sh — Installer script in English
• 🇧🇷 install_PT.sh — Script de instalação em português

chmod +x install_(LANGUAGE).sh
./install_(LAGUAGE).sh

---

🧾 License

This project is licensed under the MIT License. See the LICENSE file for more details.