|
1 | | -# Transfer |
2 | | - |
3 | | -A simple local file server app for Android. Download and upload files quickly across devices over Wi-Fi — no cables, no cloud. |
4 | | - |
5 | | -<table> |
6 | | - <tr> |
7 | | - <td> |
8 | | - <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/01.png" width="150px" /> |
9 | | - <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/02.png" width="150px" /> |
10 | | - <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/03.png" width="150px" /> |
11 | | - <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/04.png" width="150px" /> |
12 | | - <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/05.png" width="150px" /> |
13 | | - <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/06.png" width="150px" /> |
14 | | - </td> |
15 | | - </tr> |
16 | | -</table> |
17 | | - |
18 | | -Transfer makes sharing files across your local network incredibly straightforward. Think of it as a temporary USB stick you can access from any computer or device with a web browser — but without the physical stick, powered by a clean and simple UI. |
19 | | - |
20 | | -Basically, a better alternative to running `uploadserver` through Termux. |
21 | | - |
22 | | -## The Problem It Solves |
23 | | - |
24 | | -Imagine you need to transfer a file between your laptop and desktop — but you just want to send the file and move on: |
25 | | - |
26 | | -* You don’t have a USB stick or cable handy |
27 | | -* You don’t want to configure SMB (enable/run Samba, then download a client) |
28 | | -* You don’t want to use the cloud — either because it’s slow, unprivate, or you simply don’t have easy access to it |
29 | | - |
30 | | -## Key Features |
31 | | - |
32 | | -* **Effortless LAN Sharing**: Once Transfer is active, it serves files from your chosen shared folder over HTTP. Any device on the same Wi-Fi can connect using a simple web address shown in the app. |
33 | | -* **Configurable Security**: |
34 | | - * **IP Permissions**: By default, new devices attempting to connect trigger an "Allow/Deny" popup on your phone, giving you control over who accesses your files. This can be turned off for trusted networks. |
35 | | - * **Password Protection**: For an added layer, you can secure access with a password (off by default). |
36 | | -* **Powerful CLI Access (curl-friendly)**: |
37 | | - * Transfer works great with command-line tools. Upload files directly using `curl -T yourfile.txt <your-phone-ip>:8000`.Also,you can download files using`curl <phone-ip>:8000/yourfile.txt`. |
38 | | -* **Dual Browse UI**: Manage and access your shared files directly within the Transfer app on your Android device, or through the intuitive web interface on any connected computer. |
39 | | -* **Quick In-App Transfers**: |
40 | | - * **Upload**: Easily select files from your phone’s storage to add them to the shared folder. |
41 | | - * **Paste**: Paste text from your phone’s clipboard directly into a new `.txt` file in the shared folder with a single tap. |
42 | | - |
43 | | -## How to get the app |
44 | | -#### Recommended ways: |
45 | | -1. from [IzzyOnDroid](https://apt.izzysoft.de/fdroid/index/apk/com.matanh.transfer) (use an F-Droid client like Neo Store, Droid-ify, or add IzzyOnDroid repo.) |
46 | | - |
47 | | - <a href="https://apt.izzysoft.de/fdroid/index/apk/com.matanh.transfer"> |
48 | | - <img alt="Get it on IzzyOnDroid" src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroidButtonGreyBorder_nofont.png" height="54"> |
| 1 | +<h1 align="center">Transfer</h1> |
| 2 | + |
| 3 | +<p align="center"> |
| 4 | + <a href="https://github.com/matan-h/Transfer/releases"> |
| 5 | + <img src="https://img.shields.io/badge/version-0.5.0-blue.svg" alt="Version"> |
| 6 | + </a> |
| 7 | + <a href="LICENSE"> |
| 8 | + <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"> |
49 | 9 | </a> |
| 10 | + <a href="https://developer.android.com/about/versions/10"> |
| 11 | + <img src="https://img.shields.io/badge/platform-Android%2029+-brightgreen.svg" alt="Android"> |
| 12 | + </a> |
| 13 | +</p> |
50 | 14 |
|
51 | | -2. [from Google play!](https://play.google.com/store/apps/details?id=com.matanh.transfer) - new |
| 15 | +<p align="center"><strong>A simple local file server for Android</strong></p> |
52 | 16 |
|
53 | | -#### Other ways |
54 | | -Directly from [github releases](https://github.com/matan-h/Transfer/releases) (and you can also point Obtainium to this link.) |
| 17 | +<p align="center"> |
| 18 | + Transfer files instantly across devices over Wi-Fi – no cables, no cloud, no hassle. |
| 19 | +</p> |
55 | 20 |
|
56 | | -## Getting Started |
| 21 | +## Screenshots |
57 | 22 |
|
58 | | -1. Install and open Transfer on your Android device. |
59 | | -2. Grant necessary permissions and select a folder you wish to share (suggestion: create a new folder called `Storage` in your home directory). |
60 | | -3. Tap "Start Server." |
61 | | -4. The app will display an IP address (e.g., `http://192.168.1.X:8000`). |
62 | | -5. Open this address in a web browser on any other device connected to the same Wi-Fi network. |
63 | | -6. You're in! If IP permissions are on (default), you'll get a prompt on your phone to allow the new device. |
| 23 | +<p align="center"> |
| 24 | + <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/01.png" width="150px" /> |
| 25 | + <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/02.png" width="150px" /> |
| 26 | + <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/03.png" width="150px" /> |
| 27 | + <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/04.png" width="150px" /> |
| 28 | + <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/05.png" width="150px" /> |
| 29 | + <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/06.png" width="150px" /> |
| 30 | +</p> |
64 | 31 |
|
65 | | -It's designed to be that simple. Enjoy your new wireless drive. |
| 32 | +## Features |
66 | 33 |
|
67 | | -## FAQ |
68 | | -### Why does my browser show an error? |
69 | | -If your browser displays errors like `ERR_SSL_PROTOCOL_ERROR`, `ERR_CONNECTION_CLOSED`, or `SSL_ERROR_RX_RECORD_TOO_LONG`, it's probably because you're trying to open the site using **HTTPS** instead of **HTTP**. To fix, change the URL from `https://...` to `http://....` |
| 34 | +- **One-tap server**: Start HTTP server instantly |
| 35 | +- **Cross-platform**: Access from any device with a web browser |
| 36 | +- **Secure**: Device permissions and optional password protection |
| 37 | +- **CLI-friendly**: Works with `curl` and command-line tools |
| 38 | +- **No internet required**: Works over local Wi-Fi only |
70 | 39 |
|
| 40 | +## Installation |
71 | 41 |
|
72 | | -### Can I set a specific IP address to use every time? |
73 | | -Yes, you can set a [static IP](https://junipersys.com/support/article/14695) on your Android device. |
| 42 | +**Recommended:** |
| 43 | +- [IzzyOnDroid](https://apt.izzysoft.de/fdroid/index/apk/com.matanh.transfer) (F-Droid) |
| 44 | +- [Google Play Store](https://play.google.com/store/apps/details?id=com.matanh.transfer) |
74 | 45 |
|
75 | | -### Can I use Transfer without an internet connection? |
76 | | -Yes, Transfer works over your local Wi-Fi network, so an internet connection is not required. However, all devices must be connected to the same local network. |
| 46 | +**Alternative:** |
| 47 | +- [GitHub Releases](https://github.com/matan-h/Transfer/releases) |
77 | 48 |
|
78 | | -### What happens to files I share/upload to the Transfer |
79 | | -Transfer copy the files to the shared folder you set earlier. |
| 49 | +## Quick Start |
80 | 50 |
|
81 | | -### What happens if you click `T0` in the app version screen |
82 | | -It becomes `T1` :) |
| 51 | +1. Install Transfer and select a folder to share |
| 52 | +2. Tap "Start Server" |
| 53 | +3. Open the displayed IP address in any browser on the same Wi-Fi |
| 54 | +4. Allow access when prompted |
83 | 55 |
|
84 | | -## Planned changes |
| 56 | +## Usage |
85 | 57 |
|
86 | | -- [ ] add an option to change the port in the settings |
87 | | -- [ ] fallback to hotspot IP in the display. |
88 | | -- [x] automatically update the IP when Wifi changes |
| 58 | +1. Upload file(s) |
| 59 | +2. Download file(s) |
| 60 | + - Both in the app and the web interface. |
| 61 | + |
| 62 | +## FAQ |
| 63 | + |
| 64 | +**Browser shows SSL errors?** Use `http://` not `https://` |
| 65 | +**Need consistent IP?** Set up a [static IP](https://junipersys.com/support/article/14695) on your device |
| 66 | +**Files location?** Uploaded files go to your selected shared folder |
89 | 67 |
|
90 | 68 | ## Contributing |
91 | 69 |
|
92 | | -Any contributions, bugs, or feedback are welcome! |
93 | | -Feel free to open an issue or PR. |
94 | | -To get started, look at the `CONTRIBUTING.md` file |
| 70 | +Check [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Issues and PRs welcome! |
95 | 71 |
|
96 | 72 | ## License |
97 | | -this repo is Licensed under the MIT license. |
| 73 | + |
| 74 | +MIT License – see [LICENSE](LICENSE) file. |
0 commit comments