Documentation

FTP (Standard File Transfer Protocol)

Standard unencrypted RFC 959 FTP daemon for maximum device compatibility. Connect seamlessly with WinSCP, FileZilla, Cyberduck, Windows Explorer, Total Commander, smart TVs, and mobile file managers.

• Default Port: 2121 (customizable in Settings).
• Passive Port Range: Configurable port range (e.g. 5678, 5700-5710) for smooth NAT and router firewall traversal.
• UTF-8 Support: Full multilingual filename encoding support.

FTPS (Explicit TLS / SSL)

Encrypted FTP transfers using modern TLS ciphers. Encrypts both the command authentication channel and data streams.

• Certificates: Generates high-strength RSA self-signed certificates on device.
• Security: Protects credentials and file data when transferring over public or shared Wi-Fi networks.

SFTP (SSH File Transfer Protocol)

Secure subsystem running over SSH. Fully compatible with WinSCP, Cyberduck, FileZilla, Termius, and native command-line SFTP clients.

• Default Port: 2222 (separate from FTP to allow concurrent listeners).
• Host Key Algorithms: High-performance modern Ed25519 and classic RSA host keys.
• Public Key Authentication: Paste authorized SSH public keys (e.g. ssh-ed25519 ...) for passwordless, cryptographically secure authentication.

HTTP & HTTPS Web Portal

A built-in, mobile-responsive web portal accessible directly in any web browser without needing any 3rd-party software.

• Default Port: 8080 (HTTP) or 8443 (HTTPS).
• Sidebar File Tree: Interactive left sidebar folder tree for rapid navigation across deep directory structures.
• Drag & Drop: Upload multiple files and full folder hierarchies simultaneously.
• In-Browser Streaming: Stream music, play video files, and preview photos directly in the browser.
• Zip Archive Downloads: Download entire folders as compressed zip archives with one click.

1. Passwordless Phone Push Prompts ("Tap Prompt on Phone")

When connecting from a browser, simply click "Prompt phone to sign in". A high-priority notification will appear immediately on your Android device displaying the incoming client's IP and timestamp. Tap Allow on your phone to grant access instantly without typing passwords.

• Local Only: Approval prompts are broadcasted locally over your device's internal receiver — no internet connection or cloud messaging relay required.
• Session Persistence: Authenticated sessions persist securely in local browser storage until logged out or server stopped.

2. Static Login Tokens

Generate reusable, static login tokens in Wisfer Settings. Enter your token into the browser login screen for quick, reliable authentication without sharing account passwords.

3. Standard Username & Password or Guest Mode

Supports multi-user credential logins as well as one-tap anonymous guest access with configurable read-only permissions.

Receive QuickShare

Select photos, videos, audio, documents, or text in any Android application (Gallery, WhatsApp, Files, Browser, etc.) and tap QuickShare in the Share menu. Wisfer automatically saves the shared files directly to your designated QuickShare directory in the background with zero confirmation prompts needed.

Receive Save As

Tap Save As in Android's Share menu to open Wisfer's interactive bottom sheet directory picker. Choose the exact folder destination on internal or external storage, customize filenames if desired, and view real-time progress notifications with background wakelock protection.

• Supported Types: Images (image/*), Videos (video/*), Audio (audio/*), Text/Links (text/*), Documents & APKs (application/*), and all binary files (*/*).

Live Connected Devices Monitor

Wisfer tracks all active TCP socket connections in real time. Open the Connected Devices bottom sheet on the home screen to see:

• Client Device Identification: Desktop PC, Mac, Linux, smartphone, or tablet icons based on client user-agent and protocol heuristics.
• Network Details: Client IP address, connected protocol (FTP, SFTP, HTTP), connection duration, and transfer state.

QR Code Protocol Swipe Pager

The main screen features a smooth swipe pager containing formatted QR codes for each active protocol (FTP, FTPS, SFTP, and Web HTTP). Tap any QR code to enlarge it in a full-screen dialog with protocol title and IP address for easy camera scanning.

Storage Access Modes

• Plain Filesystem: Full access to internal shared storage (/sdcard), custom directories, and removable SD cards.
• Storage Access Framework (SAF): Grants access to specific user-selected folders or external USB OTG storage via the system document picker.
• Read-Only SAF Mode: Protects your device by preventing file modifications, renames, or deletions by connected clients.
• Custom Start Directory: Define the root landing folder that clients see upon initial login.

Multi-User Management

• Anonymous Login: Toggle instant guest access without requiring username or password.
• User Accounts: Configure multiple accounts with dedicated passwords and independent home paths.
• Access Levels: Assign Read-Write or strict Read-Only permissions per user.
• Account Deletion Protection: Built-in confirmation dialogs prevent accidental user deletion.

Network Interface Binding & IP Whitelist

• Allowed IP Pattern: Restrict client connections to matching IP patterns using single trailing wildcard (e.g. 192.168.1.* or 10.0.0.*).
• Bind IP Address: Bind listener sockets to a single network interface (e.g. Wi-Fi only or Hotspot only) when multiple network adapters are active.
• Idle Connection Timeout: Automatically terminate idle connections after a configurable duration (in seconds) to prevent battery drain.

Fingerprint Inspector & Regeneration

Inspect, copy, and share cryptographic fingerprints for SFTP host keys and FTPS/HTTPS TLS certificates.

• Formats: View fingerprints in standard SHA-256 HEX and Base64 representations.
• Regeneration: Generate fresh SSH host keys (Ed25519 & RSA) and TLS certificates with a single tap in Settings.

Android Ecosystem Integration

• Quick Settings Tile: Quick toggle from notification shade with optional "Require Unlock" security guard.
• Home Screen Widget: Interactive status and start/stop toggle widget for your launcher.
• Auto-Start on Boot: Automatically start file listeners on device startup (RECEIVE_BOOT_COMPLETED).
• Wi-Fi Auto-Trigger: Start automatically when connected to Wi-Fi, and stop automatically on disconnect.
• Tasker & Locale Plugin: Exposes intent actions (ACTION_START_SERVER, ACTION_STOP_SERVER, ACTION_TOGGLE_SERVER, ACTION_START_ALL_SERVICES, ACTION_STOP_ALL_SERVICES, ACTION_TOGGLE_ALL_SERVICES) to control server states through automated scripts.
• mDNS / Bonjour (DNS-SD): Broadcasts friendly server name on LAN for auto-discovery.

Material Design 3 & Material You

Wisfer is built with Jetpack Compose, featuring wallpaper-derived dynamic colors (Android 12+), pure OLED dark theme, and fluid micro-animations.