https://github.com/ramborogers/shame
Shame - Single Binary File Server
https://github.com/ramborogers/shame
access fileserver http remote server
Last synced: 7 days ago
JSON representation
Shame - Single Binary File Server
- Host: GitHub
- URL: https://github.com/ramborogers/shame
- Owner: RamboRogers
- Created: 2024-12-15T00:49:30.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-12-20T00:33:40.000Z (6 months ago)
- Last Synced: 2025-06-03T12:15:38.836Z (15 days ago)
- Topics: access, fileserver, http, remote, server
- Language: Shell
- Homepage: https://matthewrogers.org
- Size: 206 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
SHAME
Lightning-fast, zero-configuration file sharing and management tool
🪟 Windows • 🍎 Mac • 🐧 Linux
Single Binary • Zero Dependencies • Instant Setup
---
SHAME makes it effortless to upload, download, preview and manage files through your web browser. Whether you're sharing project files with teammates, hosting media content, or just need a quick way to transfer files between devices, SHAME provides a beautiful and intuitive solution that works right out of the box.
Perfect for developers, content creators, and anyone who needs hassle-free file sharing, SHAME combines the simplicity of a single binary with the power of modern web technologies. No complex setup, no dependencies, no accounts required - just run the binary and start sharing instantly.
## 🌟 What's New in v1.0.3s
- **🛠️ Bug Fixes**: Resolved file deletion issues with special characters
- **🔐 Authentication**: Enhanced security with authenticated mode by default
- **🌐 Cloudflare Integration**: Secure HTTPS access with dynamic tunneling
- **🛡️ Access Controls**: Flexible modes including read-only and insecure options
- **🔗 Direct Link Sharing**: Share files with a single click
- **📁 WebDAV Support**: Mount SHAME as a network drive on any device
## ⚡ Installation
The binary is available for Windows, Mac, and Linux. It's in the repo above. I've put together scripts to install it on each platform. You can review the scripts before running them above.
### 🪟 Windows Installation
Copy and paste into PowerShell:
```powershell
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/RamboRogers/shame/master/install_windows.ps1'))
```
### 🍎 Mac (Apple Silicon & Intel) and 🐧 Linux
Copy and paste into your terminal:
```bash
curl -L https://raw.githubusercontent.com/RamboRogers/shame/master/install.sh | sh
```
Now you can run `shame` from anywhere on your machine:
```bash
shame
```
## 🚀 Usage
SHAME offers flexible deployment options to suit your needs:
```bash
# Standard Usage (Authenticated by default)
shame # Start server in normal mode
shame readonly # Start server in read-only mode
# Cloudflare Tunnel Options (Secure Remote Access)
shame tunnel # Start with Cloudflare tunnel for HTTPS
shame tunnel readonly # Tunnel with read-only mode
# Local Network Options (Use with caution)
shame insecure # Start server without authentication (UNSAFE)
shame insecure readonly # Start without auth in read-only mode (UNSAFE)
# Help & Version
shame help # Show help message
shame version # Show version information
```
### 🌐 Sharing Modes
### Authenticated Mode
- Default secure mode
- Access control
- File operation logging
- Perfect for remote access
### Tunnel Mode
- Secure HTTPS access
- Cloudflare integration
- Public accessibility
- Single-use share links
### Read-Only Mode
- Secure file distribution
- Prevent modifications
- View-only access
- Available in all modes
> ⚠️ **Security Notice**: The `insecure` flag disables authentication. Only use this option on trusted networks and when absolutely necessary.
Type `shame` in the folder you want to share from:
The console will output the URL to the web interface.
### 🖥️ Web Interface
Browse folders and preview images with mouse hover and keyboard navigation. Press enter to download files.
## ✨ Features
### Core Features
- 🚀 Single Binary, Zero Dependencies
- 🌍 Cross-Platform Support
- ⚡ Instant Setup
- 🎨 Beautiful Dark Mode Interface
- 🔐 Single-Use Share Links
### File Operations
- 📂 Directory Browsing
- ⬆️ Drag & Drop Upload
- ⬇️ Fast Downloads
- 🗑️ File Management
- 🔗 Direct Link Sharing
### Security & Access
- 🛡️ Read-Only Mode
- 🌐 HTTPS via Cloudflare
- 🔒 Access Controls
- 📊 Progress Tracking
- 🎯 Visual Feedback
## 💡 Use Cases
- **Local Development**: Share project files instantly with teammates
- **Media Sharing**: Quick image and file previews
- **File Transfer**: Move files between devices effortlessly
- **Temporary Hosting**: Set up quick file sharing servers
## ⚖️ License and Contact
This project is provided as is. Use at your own risk.
### Connect With Me 🤝
[](https://github.com/RamboRogers)
[](https://x.com/rogerscissp)
[](https://matthewrogers.org)
