152 lines
4.3 KiB
Markdown
152 lines
4.3 KiB
Markdown
# iPhone-Linux Transfer Service
|
|
|
|
A web-based application for transferring files and links between iPhone and Linux devices with a secure and user-friendly interface.
|
|
|
|
## Features
|
|
- **Upload and manage links and files:** Upload HTML links, images, and other files from your device.
|
|
- **Secure authentication:** User login with salted and hashed password storage for enhanced security.
|
|
- **Automatic lockout:** Users are locked out after multiple unsuccessful login attempts.
|
|
- **Device identification:** Uploaders are identified by device type and IP address.
|
|
|
|
---
|
|
|
|
## Table of Contents
|
|
1. [Installation](#installation)
|
|
2. [Usage](#usage)
|
|
3. [Database Reset](#database-reset)
|
|
4. [Security](#security)
|
|
5. [Dependencies](#dependencies)
|
|
6. [Known Issues](#known-issues)
|
|
7. [Contributing](#contributing)
|
|
8. [License](#license)
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
- Python 3.x
|
|
- `pip` (Python package installer)
|
|
- `venv` module for creating virtual environments
|
|
- Required binaries: `flask`, `sqlite3`, `curl`, `openssl`
|
|
|
|
### Automated Installation
|
|
1. Clone this repository:
|
|
git clone https://github.com/kleinpanic/iphone-linux-transfer.git
|
|
cd iphone-linux-transfer
|
|
|
|
2. Run the installation script:
|
|
./install.sh
|
|
This script will:
|
|
- Check for the `venv` module and attempt installation if missing
|
|
- Check for required binaries and prompt you to install any that are missing
|
|
- Set up a virtual environment and install all Python dependencies
|
|
- Set up an Assets directory so the code can properly work
|
|
|
|
### Manual Installation
|
|
If you'd prefer to install everything manually, follow these steps:
|
|
|
|
1. Install Python 3.x and `venv`.
|
|
2. Create a virtual environment:
|
|
python3 -m venv venv
|
|
3. Activate the virtual environment:
|
|
- **Linux/Mac:** `source venv/bin/activate`
|
|
|
|
4. Install the required Python packages:
|
|
pip install -r requirements.txt
|
|
|
|
---
|
|
|
|
## Usage
|
|
1. **Activate the virtual environment**:
|
|
- **Linux/Mac:** `source venv/bin/activate`
|
|
|
|
2. **Start the application**:
|
|
python app.py
|
|
The application will run on `https://127.0.0.1:5000` by default.
|
|
|
|
3. **Access the application**:
|
|
- Open your browser and go to `https://127.0.0.1:5000`.
|
|
|
|
### Available Features
|
|
- **Uploading:** Upload links, images, and other files.
|
|
- **Downloading:** Download uploaded content.
|
|
- **Renaming:** Rename uploaded files.
|
|
- **Preview:** Preview uploaded images directly from the app.
|
|
- **Delete:** Delete uploaded content.
|
|
- Curl: compable with curl ideally.
|
|
|
|
---
|
|
|
|
## Database Reset
|
|
|
|
To start fresh with a new database setup, you can use the reset script provided:
|
|
|
|
1. Ensure your virtual environment is activated:
|
|
source venv/bin/activate
|
|
2. Run the reset script:
|
|
python reset_db.py
|
|
This will:
|
|
- Remove all existing entries from the database
|
|
- Reinitialize the tables for users and uploads
|
|
|
|
**Note**: Use this command with caution as it will remove all existing data.
|
|
|
|
---
|
|
|
|
## Security
|
|
|
|
- Passwords are salted and hashed before being stored.
|
|
- After 3 unsuccessful login attempts, users are locked out, and their IP address is recorded in `locked_ips.txt`.
|
|
- To unlock a user, manually remove their IP from `locked_ips.txt`.
|
|
|
|
---
|
|
|
|
## Dependencies
|
|
|
|
This project requires the following:
|
|
- **Python Packages** (specified in `requirements.txt`)
|
|
- `Flask`
|
|
- `Werkzeug`
|
|
- **System Binaries**
|
|
- `flask`
|
|
- `sqlite3`
|
|
- `curl`
|
|
- `openssl`
|
|
|
|
---
|
|
|
|
## Known Issues
|
|
|
|
- The application is currently set up for development use. It is not secure for deployment in a production environment.
|
|
- Make sure you properly configure your firewall and network settings when using this application on a publicly accessible server.
|
|
|
|
---
|
|
|
|
## Contributing
|
|
|
|
Contributions are welcome! Please follow these steps to contribute:
|
|
|
|
1. **Fork the repository** on GitHub.
|
|
2. **Clone your fork**:
|
|
git clone https://github.com/yourusername/iphone-linux-transfer.git
|
|
3. **Create a new branch** for your feature or bug fix:
|
|
git checkout -b feature-name
|
|
4. **Make your changes**, commit them, and push to your fork:
|
|
git add .
|
|
git commit -m "Description of your changes"
|
|
git push origin feature-name
|
|
5. Open a **Pull Request** on the main repository.
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License. Do whatever the fuck you want with it.
|
|
|
|
---
|
|
|
|
## Support
|
|
|
|
For any issues or suggestions, please open an issue on the GitHub repository or contact me directly.
|