Metadata-Version: 2.4
Name: filesh
Version: 1.0.0
Summary: Simple and modern LAN file sharing server with web UI
Project-URL: Homepage, https://github.com/kutaykoca/filesh
Project-URL: Repository, https://github.com/kutaykoca/filesh
Project-URL: Issues, https://github.com/kutaykoca/filesh/issues
Author: Kutay Koca
License-Expression: MIT
License-File: LICENSE
Keywords: download,file-server,file-sharing,http-server,lan,local-network,upload,web-ui
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: System :: Networking
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Requires-Dist: flask>=2.0.0
Description-Content-Type: text/markdown

# filesh

Simple and modern LAN file sharing server with a beautiful web UI.

Share files and folders across your local network with ease. Just run `filesh` and access from any device on the same network.

## Features

- **Modern Web UI** - Clean, responsive interface with light/dark mode
- **Drag & Drop Upload** - Simply drag files to upload
- **Multi-file Upload** - Upload multiple files at once with progress bar
- **File Preview** - Preview images, videos, audio, and text files
- **QR Code** - Scan to connect from mobile devices instantly
- **Create Folders** - Organize files by creating new folders
- **Delete Files** - Remove files and folders from the web interface
- **File Icons** - Distinct icons for different file types
- **Cross-platform** - Works on Windows, macOS, and Linux

## Installation

```bash
pip install filesh
```

## Usage

### Basic Usage

Share current directory on port 8080:

```bash
filesh
```

### Options

```
filesh [OPTIONS] [DIRECTORY]

Arguments:
  DIRECTORY          Directory to share (default: current directory)

Options:
  -p, --port PORT    Port to run server on (default: 8080)
  -H, --host HOST    Host to bind to (default: 0.0.0.0)
  --hidden           Show hidden files
  -q, --quiet        Quiet mode - minimal output
  -h, --help         Show help message
```

### Examples

```bash
# Share current directory
filesh

# Share on a different port
filesh -p 3000

# Share a specific folder
filesh ~/Downloads

# Share with custom port and folder
filesh -p 3000 ~/Music

# Show hidden files
filesh --hidden

# Quiet mode (minimal output)
filesh -q
```

### Output

```
  filesh
  ------
  Sharing: /home/user/Downloads
  Local:   http://127.0.0.1:8080
  Network: http://192.168.1.100:8080

  Ctrl+C to stop
```

Open the Network URL on any device connected to the same network to access the shared files.

## Screenshots

### Light Mode
Clean and minimal interface with file browser, upload zone, and navigation.

### Dark Mode
Easy on the eyes with a dark theme. Toggle with the sun/moon button.

## How It Works

1. Run `filesh` in your terminal
2. Note the Network URL displayed
3. Open the URL on any device in the same network
4. Browse, upload, download, and manage files

## Requirements

- Python 3.8+
- Flask 2.0+

## License

MIT License - see [LICENSE](LICENSE) for details.

## Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.
