Initial commit

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Todd
2026-03-29 22:42:55 -04:00
commit 0d7b2b1aab
389 changed files with 280296 additions and 0 deletions

132
docs/web/QUICKSTART.md Normal file
View File

@@ -0,0 +1,132 @@
# Media Downloader Web Interface - Quick Start Guide
## Installation & First Run
### 1. Install Backend Dependencies
```bash
cd /opt/media-downloader/web/backend
pip3 install -r requirements.txt
```
### 2. Install Frontend Dependencies
```bash
cd /opt/media-downloader/web/frontend
npm install
```
### 3. Start the Web Interface
```bash
cd /opt/media-downloader/web
./start.sh
```
The script will:
- ✓ Check all dependencies
- ✓ Install missing packages
- ✓ Start the backend API (port 8000)
- ✓ Start the frontend UI (port 5173)
- ✓ Open your browser automatically
### 4. Access the Dashboard
Open your browser to: **http://localhost:5173**
## What You Can Do
### Dashboard
- View real-time download statistics
- See platform distribution charts
- Monitor recent activity
- Check system status
### Downloads
- Browse all downloaded media
- Filter by platform or source
- Delete unwanted records
- View file details
### Platforms
- See all configured platforms
- Trigger manual downloads
- Check platform status
- View account information
### Logs
- Real-time log streaming
- Filter by log level
- Export logs as text
- Monitor system health
### Configuration
- Edit settings.json directly
- Validate JSON syntax
- Save changes instantly
- Reference documentation
## One-Line Start
```bash
cd /opt/media-downloader/web && ./start.sh
```
## Stopping the Interface
Press `Ctrl+C` in the terminal where you started the services.
## Troubleshooting
**Port already in use?**
```bash
# Kill existing processes
sudo lsof -ti:8000 | xargs kill -9
sudo lsof -ti:5173 | xargs kill -9
```
**Backend won't start?**
```bash
# Check logs
tail -f /tmp/media-downloader-api.log
```
**Frontend build errors?**
```bash
cd /opt/media-downloader/web/frontend
rm -rf node_modules package-lock.json
npm install
```
**Database connection errors?**
```bash
# Verify database exists
ls -la /opt/media-downloader/database/media_downloader.db
```
## Production Deployment
See `README.md` for:
- Systemd service setup
- Nginx reverse proxy configuration
- Docker deployment
- SSL/HTTPS setup
- Authentication
## Next Steps
1. **Configure platforms** - Go to Configuration tab
2. **Trigger a download** - Use Platforms tab
3. **Monitor logs** - Watch Logs tab in real-time
4. **View statistics** - Check Dashboard
## Support
- Documentation: `/opt/media-downloader/web/README.md`
- Main app docs: `/opt/media-downloader/docs/`
- API docs: `http://localhost:8000/docs` (when running)
---
**Version:** 1.0.0
**Built for:** Media Downloader v6.2.2