TolinoShare v0.8

📚 Simple, secure file sharing for ebook libraries

A self-hosted Flask application that lets you share, upload, and manage ebook files with built-in user authentication and library management. Designed for Tolino e-readers and any modern browser.

📱 Device Support: Works great with Tolino ✅ and Rakuten Kobo ✅ | Limited support for Kindle (EPUB requires conversion)

✨ Features

✅ User Authentication - Secure login and registration system
✅ File Uploads - Upload books in PDF, EPUB, TXT, FB2 formats (max 100MB)
✅ Share & Download - Share books with other users or download publicly shared files
✅ Library Management - Organize your personal ebook library
✅ Modern UI - Clean, responsive design; works on mobile, tablet, and desktop
✅ Self-Hosted - Full control over your data, runs locally or on your server
✅ Docker Ready - One-command deployment with Docker Compose
✅ Tolino Compatible - Minimal, JavaScript-free interface works on Tolino e-readers
✅ Kobo Compatible - EPUB, PDF, TXT support for Rakuten Kobo devices

🚀 Quick Start (30 seconds)

Requirements

• Docker & Docker Compose installed

Installation

git clone https://github.com/Maxi2555/tolinofileshare.git
cd tolinofileshare
docker compose up

Access at: http://localhost:7847

That's it! The app is running.

📖 How to Use

For First-Time Users

1. Register an account

   • Go to http://localhost:7847
   • Click "Register"
   • Create username and password

2. Upload files

   • Click "Home"
   • Select a file (PDF, EPUB, TXT, or FB2)
   • Click Upload

3. Access your library

   • Click "My Library"
   • Download your files anytime

For Tolino E-Reader Users

1. On your computer: Go to http://your-server:7847
2. Register and upload books
3. On your Tolino: Open browser
4. Visit http://your-server:7847/u/yourusername
5. Bookmark this page for quick access
6. Download books directly to Tolino

🌐 Server Deployment

Deploy to VPS / Cloud Server

# 1. SSH into your server
ssh user@your-server.com

# 2. Clone repository
git clone https://github.com/Maxi2555/tolinofileshare.git
cd tolinofileshare

# 3. Create environment config
cat > .env << EOF
SECRET_KEY=$(python3 -c 'import secrets; print(secrets.token_hex(32))')
EOF

# 4. Start services
docker compose up -d

# 5. Access at http://your-server-ip:7847

Configuration

Create a .env file in the project root:

# IMPORTANT: Generate a strong secret key!
SECRET_KEY=your-super-secret-key-change-this-in-production

# Default paths (change if needed)
UPLOAD_FOLDER=/data/uploads
DATABASE_URL=sqlite:////data/tolinoshare.db

Generate a strong SECRET_KEY:

python3 -c 'import secrets; print(secrets.token_hex(32))'

🔒 Security Checklist

Before going public:

• Changed SECRET_KEY to a strong random value
• Set strong passwords for user accounts
• (Optional) Set up HTTPS/SSL with reverse proxy (nginx)
• Backed up /data/ directory regularly
• Restricted network access to port 7847 if needed
• Updated Docker images: docker compose down && docker compose pull && docker compose up -d

📦 Supported File Types

Format	Max Size	Use Case
PDF	100 MB	Documents, ebooks
EPUB	100 MB	E-reader format
TXT	100 MB	Plain text
FB2	100 MB	FictionBook format

� Device Compatibility

Device	Status	Supported Formats	Notes
Tolino	✅ Full	EPUB, PDF, TXT, FB2	Works perfectly with Tolino browser
Rakuten Kobo	✅ Full	EPUB, PDF, TXT	No FB2 support; excellent with EPUB
Kindle	⚠️ Limited	PDF, TXT only	EPUB needs conversion to MOBI/AZW3
Web Browser	✅ Full	All formats	Modern browser on PC/Mac/Linux

Note: TolinoShare serves files directly to your device - you don't need to convert files, just ensure your device supports the format.

�🔄 Updating

To get the latest version:

git pull origin main
docker compose down
docker compose up --build

🐛 Troubleshooting

Port 7847 already in use?

Edit docker-compose.yml, change the first 7847 to another port:

ports:
  - "9999:8080"  # Now use http://localhost:9999

Docker permission denied?

sudo usermod -aG docker $USER
newgrp docker

Can't access from other devices?

Use your server's IP address instead of localhost:

http://192.168.1.100:7847  # Replace with your server IP

Data disappeared after restart?

Ensure you didn't use docker compose down -v (which deletes volumes). Use:

docker compose down  # Keeps data
docker compose up    # Restarts with data intact

📁 Project Structure

tolinofileshare/
├── app/
│   ├── templates/          # HTML templates (modern UI)
│   │   ├── base.html       # Main layout
│   │   ├── index.html      # Home & upload
│   │   ├── login.html      # Login page
│   │   ├── register.html   # Registration
│   │   ├── upload.html     # Upload form
│   │   └── user_library.html  # User's library
│   ├── routes/
│   │   ├── auth.py         # Login/register routes
│   │   ├── upload.py       # Upload routes
│   │   └── share.py        # Download/share routes
│   ├── utils/
│   │   ├── file_check.py   # File validation
│   │   └── link_generator.py  # Safe link generation
│   ├── models.py           # Database models
│   ├── config.py           # Configuration
│   └── __init__.py         # Flask app factory
├── docker-compose.yml      # Docker setup
├── Dockerfile              # Container configuration
└── requirements.txt        # Python dependencies

🔧 Development

Local Setup

# Install dependencies
pip install -r requirements.txt

# Run development server
python -m flask run --reload

With Docker (Development)

docker compose up --build

View logs:

docker compose logs -f app

Stop:

docker compose down

🌍 Screenshots

• Modern UI - Light, gradient design optimized for all devices
• File Upload - Drag-and-drop or click to upload
• Library View - Easy access to all your files
• Tolino Compatible - Works in basic browsers

📋 API Routes

Route	Method	Description
/	GET	Home page & upload form
/register	GET, POST	User registration
/login	GET, POST	User login
/logout	GET	User logout
/upload	POST	Upload a file
/u/<username>	GET	View user's library
/download/<file_id>	GET	Download file

🔐 Privacy & Security

• Local Storage: All files stored on your server, under your control
• Encrypted Sessions: User sessions are securely managed
• Password Hashing: Passwords stored securely with werkzeug
• No Telemetry: Zero external tracking or analytics
• Open Source: Full source code transparency

📄 License

MIT License - See LICENSE file

� Transparency Note

This project includes code and documentation that were partially generated using AI (GitHub Copilot).

However:

• ✅ All code has been reviewed and tested
• ✅ All documentation is accurate and complete
• ✅ Security is manually verified and production-ready
• ✅ Source code is fully open and transparent
• ✅ AI was used to accelerate development, not replace human review

🤝 Contributing

• Found a bug? Open an Issue
• Have a feature idea? Submit a Pull Request
• Questions? Discussions welcome!

See CONTRIBUTING.md for guidelines.

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Check README & code comments

---

Version: v0.8
Status: Stable & Production Ready
Last Updated: April 2026
Maintained by: @Maxi2555