bits & crumbs — cookie and binary logo
← ByteBridge overview

Android · Phone and tablet

Your files, from your phone.

Use the native Android app to browse local folders, reach a server, preview files, and copy between locations on the go.

Illustrated example · Switch between a server folder and phone storage.
Minimum OS
Android 9
Start with
A phone folder or SFTP / SMB credentials
Web server
Optional for direct connections

01 / FIRST CONNECTION

Install and connect

  1. Install ByteBridge

    Open the ByteBridge APK from your trusted release source on Android 9 or newer. Current builds use com.bytebridge.files and install separately from older com.homeport.files builds. Export phone-only settings or files you need, pair the new app with Web, review grants, then remove the old app when ready. For an APK installation, Android may ask you to allow installation from the app opening the file. You can turn that permission off afterward.

  2. Give ByteBridge a place to start

    Open Phone from the dock. Browse shared internal storage and approve the storage permission requested by this build. Start with a test folder. The retired “Choose a folder with Android” option is no longer part of Phone setup; explicit folder grants for Device Bridge and received files remain separate.

  3. Add a server or share

    Open Connections → Add connection. For SFTP, enter a name, host, port, username, and password or private key. Verify the host key before trusting a new SSH server. For SMB, enter the host and share name plus the credentials required by that share. Run Check connection before saving or opening the location.

  4. Browse two locations and copy a file

    Use the dock selectors to choose the source and destination. Open the relevant folders, select a file, and use the copy action to choose the other location. Follow the job in Transfers and check the destination.

02 / ANDROID DEVICE BRIDGE

Pair your phone with ByteBridge Web

  1. Create a pairing on ByteBridge Web

    Sign in to your reachable Web instance. Open Connections → Add Android Device and display the pairing QR code.

  2. Approve the server and folder on Android

    On the phone, open Settings → Web Connections → Scan QR Code. Review the instance, then grant a folder. Start with read-only access or explicitly enable writes if your workflow needs them.

  3. Open the paired phone in Web

    Choose the phone from Connections or the Files connection selector. Use the live bridge to browse the granted folders. If your server and phone are on different networks, the phone still needs a route to the Web instance.

Choose when the phone serves files

In Web Connections → Details → Server license, check this server’s entitlement and expiration. If the pairing says License required, import or renew the signed license on that server, then refresh. Your pairing and folder grants are retained. Direct phone storage and independently configured direct file connections can still be used.

  1. Open the paired server’s Connection Mode. Use Always Connected to serve approved folders while Android permits the foreground service to run. Its notification gives you a way to disconnect.
  2. Choose On-Demand to browse the phone while ByteBridge is open and receive queued files using background work when Android allows. Select a writable Received Files Location for delivery. This grant is separate from a folder you share read-only.
  3. For saved connection profiles, enable Allow connection sync with this phone in Web and Automatically sync connection lists in Android’s pairing settings. Use Sync connections now. Sharing saved credentials needs consent on both ends. Syncing profiles and copying file contents are separate operations.

Use Dropbox and OneDrive through your server

  1. In ByteBridge Web, add the cloud connection and complete the provider’s authorization. Open a folder and preview a file in Web first.
  2. Pair Android to this licensed Web server over trusted HTTPS. In the phone’s Connection Sync permissions on Web, authorize the cloud connection for remote file access. Enable writes only if required.
  3. Sync connections on Android, select the server-provided connection in a dock pane, then browse, preview or copy a cloud document to Phone.

The route is Android → your ByteBridge server → cloud provider. The server holds the provider authorization. Android no longer adds Dropbox or OneDrive accounts or runs their OAuth setup; legacy native cloud profiles are retired. If access fails, check the provider connection in Web, the server license and the phone’s relay grant.

Try server-routed cloud files in the Android demo ↗

Work from the phone

Tap a dock location to browse it. Use the magnifying glass to search, switch between list and tile views, then open the file’s actions to preview, copy or move it. For a first run, copy a test document to another location and reopen it there.

03 / COMMON ISSUES

Troubleshooting

My server works on Wi-Fi only.

A private LAN address needs a route from the phone. Connect to the same LAN or your configured VPN, then use the address reachable on that network. With Tailscale, sign into the official Tailscale app and connect before testing.

I can connect but cannot see a folder.

Check the connection’s default folder and the remote account’s permissions. For an Android folder, reopen the system picker and approve the specific folder you want to use.

The QR code expired.

Generate a fresh code in Web and scan it promptly. Open the same Web root URL from the phone to confirm reachability before pairing again.

KEEP GOING

Run your own ByteBridge Web server.

Open guide