{"id":46014421,"url":"https://github.com/ancarsenat/filetransferapp","last_synced_at":"2026-03-01T01:01:37.547Z","repository":{"id":324108033,"uuid":"1044167059","full_name":"AnCarsenat/FileTransferApp","owner":"AnCarsenat","description":"Transfer files from your phone to desktop (desktop app+web interface)","archived":false,"fork":false,"pushed_at":"2025-11-13T21:13:31.000Z","size":21453,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-13T22:14:21.582Z","etag":null,"topics":["desktop","easy-to-understand","fast","file-transfer","phone","python","tool","tools","web"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AnCarsenat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-25T09:31:53.000Z","updated_at":"2025-11-13T21:11:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AnCarsenat/FileTransferApp","commit_stats":null,"previous_names":["ancarsenat/filetransferapp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/AnCarsenat/FileTransferApp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnCarsenat%2FFileTransferApp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnCarsenat%2FFileTransferApp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnCarsenat%2FFileTransferApp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnCarsenat%2FFileTransferApp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AnCarsenat","download_url":"https://codeload.github.com/AnCarsenat/FileTransferApp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnCarsenat%2FFileTransferApp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29957128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-28T22:53:01.873Z","status":"ssl_error","status_checked_at":"2026-02-28T22:52:50.699Z","response_time":90,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["desktop","easy-to-understand","fast","file-transfer","phone","python","tool","tools","web"],"created_at":"2026-03-01T01:01:36.842Z","updated_at":"2026-03-01T01:01:37.516Z","avatar_url":"https://github.com/AnCarsenat.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# File Transfer App\n\nA desktop application that creates a local web server for transferring files wirelessly between your phone and computer in both directions.\n\n\u003cimg src=\"images/app_screenshot.png\" alt=\"App Screenshot\" width=\"600\"\u003e\n\n## Features\n\n- **Bidirectional Transfer**: Send files from phone to computer AND from computer to phone\n- **Desktop GUI**: Clean tkinter interface for easy server management\n- **Local Web Server**: Flask-based server accessible from any device on your network\n- **Mobile-Optimized**: Responsive web interface designed for all phone sizes\n- **Real-time Progress**: Upload progress bars with percentage, file size, and time estimates\n- **Multiple Upload Modes**: Single file or multiple file uploads\n- **File Sharing**: Add files from your computer to share with your phone\n- **Auto File Management**: Automatic folder creation and file organization\n- **Network Discovery**: Automatically detects and displays your network IP address\n- **No Redirects**: AJAX-based uploads keep you on the same page\n\n## Screenshots\n\n### Desktop Application\n\u003cimg src=\"images/desktop_interface.png\" alt=\"Desktop Interface\" width=\"500\"\u003e\n\n### Mobile Web Interface\n\u003cimg src=\"images/mobile_interface.png\" alt=\"Mobile Interface\" width=\"500\"\u003e\n\n## Installation\n\n### Option 1: Download Executable (Recommended)\n1. Go to the [Releases](../../releases) page\n2. Download the appropriate version for your system:\n   - **Windows**: `FileTransferApp-Windows.exe`\n   - **Linux**: `FileTransferApp-Linux`\n   - **macOS**: `FileTransferApp-macOS`\n3. Run the executable (no installation required!)\n\n### Option 2: Run from Source\n**Prerequisites:**\n- Python 3.6 or higher\n- Flask library\n\n**Setup:**\n```bash\n# Install Flask\npip install flask\n\n# Run the application\npython file_transfer_app.py\n```\n\n## Usage\n\n### Starting the Server\n1. Launch the desktop application\n2. Click **\"▶️ Start Server\"** in the desktop interface\n3. The app will display two URLs:\n   - **Local**: `http://localhost:8080` (works only on your computer)\n   - **Network**: `http://192.168.x.x:8080` (use this on your phone)\n\n\u003cimg src=\"images/server_started.png\" alt=\"Server Started\" width=\"500\"\u003e\n\n### Connecting from Your Phone\n1. Ensure your phone is connected to the same WiFi network as your computer\n2. Open your phone's web browser\n3. Navigate to the **Network URL** shown in the desktop app\n4. You should see the file transfer interface with two sections\n\n\u003cimg src=\"images/phone_connection.png\" alt=\"Phone Connection\" width=\"300\"\u003e\n\n## File Transfer Modes\n\n### 📤 Send to Computer (Phone → Computer)\nUpload files from your phone to your computer.\n\n**Steps:**\n1. On your phone, scroll to the **\"📤 Send to Computer\"** section\n2. Choose **Single File** or **Multiple Files** mode\n3. Select your files\n4. Tap **\"Upload File(s)\"**\n5. Files are saved to the `downloads/` folder on your computer\n\n\u003cimg src=\"images/upload_to_computer.png\" alt=\"Upload to Computer\" width=\"350\"\u003e\n\n### 📥 Get from Computer (Computer → Phone)\nDownload files from your computer to your phone.\n\n**Steps:**\n1. On your computer, click **\"📤 Add Files to Share\"**\n2. Select files you want to share with your phone\n3. On your phone, scroll to the **\"📥 Get from Computer\"** section\n4. Tap **\"🔄 Refresh File List\"** to see available files\n5. Tap **\"⬇️ Download\"** next to any file you want\n\n\u003cimg src=\"images/download_from_computer.png\" alt=\"Download from Computer\" width=\"350\"\u003e\n\n### Upload Progress\nDuring upload, you'll see:\n- Visual progress bar with percentage\n- Data transferred (e.g., \"2.1 MB / 5.3 MB\")\n- Elapsed time\n- Estimated time remaining\n\n\u003cimg src=\"images/progress_detail.png\" alt=\"Upload Progress Detail\" width=\"400\"\u003e\n\n## File Management\n\n### Folder Structure\nThe app creates two folders in the same directory as the application:\n\n```\nyour_project_folder/\n├── file_transfer_app.py (or .exe)\n├── downloads/              # Files received FROM your phone\n│   ├── photo1.jpg\n│   ├── document.pdf\n│   └── video.mp4\n└── uploads/                # Files you share TO your phone\n    ├── presentation.pptx\n    ├── music.mp3\n    └── ebook.pdf\n```\n\n### File Organization\n- **downloads/**: Automatically receives files uploaded from your phone\n- **uploads/**: Contains files you've selected to share with your phone\n- Files maintain their original names\n- If a file with the same name exists, it will be overwritten\n- All transfers appear in the desktop app's activity log\n\n\u003cimg src=\"images/file_organization.png\" alt=\"File Organization\" width=\"500\"\u003e\n\n## Troubleshooting\n\n### Phone Can't Connect\n1. **Check Network**: Ensure both devices are on the same WiFi network\n2. **Use Correct IP**: Use the Network URL (192.168.x.x), not localhost\n3. **Firewall**: Allow Python/the app through your computer's firewall\n4. **Router Settings**: Some routers block device-to-device communication\n\n### Files Not Showing in \"Get from Computer\"\n1. Click **\"Add Files to Share\"** on the desktop app first\n2. Tap **\"🔄 Refresh File List\"** on your phone\n3. Make sure files were successfully copied to the `uploads/` folder\n\n### Slow Performance on Old Phones\nThe interface is optimized for older devices:\n- Minimal JavaScript and CSS\n- Large touch targets\n- Simple HTML forms\n- Sequential file uploads\n- Responsive design that adapts to screen size\n\n### Common Issues\n| Issue | Solution |\n|-------|----------|\n| \"Connection refused\" | Check if server is running and firewall allows connections |\n| \"Page not loading\" | Verify you're using the Network IP, not localhost |\n| \"Upload fails\" | Try smaller files first, check available disk space |\n| \"No files in download section\" | Add files using \"Add Files to Share\" button on desktop |\n| \"Can't see uploaded files\" | Check the downloads folder in the same directory as the app |\n\n## Technical Details\n\n### System Requirements\n- **Desktop**: Windows 7+, macOS 10.12+, or Linux with Python 3.6+\n- **Mobile**: Any device with a web browser\n- **Network**: WiFi network connecting both devices\n\n### Port Configuration\n- Default port: 8080\n- Customizable in the source code if needed\n- Automatically finds available network interfaces\n\n### Supported File Types\n- All file types supported\n- No file size restrictions (limited by available disk space and network speed)\n- Multiple files can be uploaded simultaneously\n\n## Security Notes\n\n- **Local Network Only**: The server only accepts connections from your local network\n- **No Authentication**: Anyone on your network can access the interface\n- **No Encryption**: Files are transferred over HTTP (not HTTPS)\n- **Temporary Server**: Server stops when you close the desktop application\n- **Privacy**: All transfers stay on your local network - nothing goes to the internet\n\n## Building from Source\n\n### Windows\n```batch\nbuild.bat\n```\nCreates `release/FileTransferApp-Windows.exe`\n\n### Linux/Mac\n```bash\nchmod +x build.sh\n./build.sh\n```\nCreates `release/FileTransferApp-Linux` or `FileTransferApp-macOS`\n\n### Requirements for Building\n- Python 3.6+\n- PyInstaller (automatically installed by build scripts)\n- Flask\n\n## Development\n\n### Code Structure\n```\nfile_transfer_app.py\n├── Flask Web Server\n│   ├── /upload (receive files from phone)\n│   ├── /list_files (list files to share)\n│   └── /download/\u003cfilename\u003e (send files to phone)\n├── Desktop GUI (tkinter)\n│   ├── Server controls\n│   ├── File sharing interface\n│   └── Activity log\n└── File Management\n    ├── downloads/ folder handling\n    └── uploads/ folder handling\n```\n\n### Customization\nYou can modify:\n- Upload/download directory paths\n- Server port number\n- Web interface styling\n- File handling behavior\n- Maximum file sizes\n\n## License\n\nThis project is open source. Feel free to modify and distribute as needed.\n\n## Contributing\n\nFound a bug or want to add a feature? Contributions are welcome:\n1. Fork the project\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## Support\n\nFor issues or questions:\n- Check the troubleshooting section above\n- Review the error messages in the desktop application\n- Ensure all prerequisites are installed correctly\n- Check that both devices are on the same WiFi network\n\n---\n\n**Enjoy seamless bidirectional file transfers between your devices!** 📱↔️💻","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fancarsenat%2Ffiletransferapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fancarsenat%2Ffiletransferapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fancarsenat%2Ffiletransferapp/lists"}