Throughput
Measures peer-to-peer data transfer speed between two devices running Lirum.
Overview
Throughput tests how fast two nearby devices can transfer data to each other over a local connection. One device acts as the Sender and the other as the Receiver. During the transfer, you see live speed measurements and a real-time graph of throughput performance.
Table Of Contents
Requirements
To run a throughput test, you need:
- Two devices both running the Lirum app.
- Both devices must be nearby (on the same local network or within peer-to-peer range).
- Local Network permission must be granted on both devices. The system will prompt you for this permission the first time you use Throughput.
Configuration
At the top of the screen, a configuration card lets you choose two options:
- Media -- a segmented picker that selects the transport used for the transfer:
- Bluetooth LE (BLE) -- the test runs over a Bluetooth Low Energy connection.
- Wi-Fi -- the test runs over a local Wi-Fi (peer-to-peer) connection.
- Role -- a segmented picker that selects what this device does:
- Sender -- this device will send data to the other device and control the test.
- Receiver -- this device will receive data from the sender.
A connection status indicator shows whether you are connected to a peer.
Peer Discovery
Once you select a role, Throughput begins looking for the other device.
In Sender mode, a peer discovery section appears listing nearby devices that are available. Each discovered peer shows signal strength information when available -- signal strength (RSSI) is shown for BLE peers; Wi-Fi peers do not report RSSI. Tap a peer to connect, or tap again to disconnect. You can only connect to one peer at a time.
In Receiver mode, the screen shows a readiness status indicating that the device is waiting for a Sender to connect. No further action is needed on the Receiver side -- just keep the screen open and wait for the Sender to initiate the connection.
Transfer Test
After both devices are connected, the Sender can start the test.
- Tap Start on the Sender device to begin the data transfer.
- Tap Stop at any time to end the test early.
Only the Sender device controls when the test starts and stops. The Receiver device participates automatically.
During the transfer, two metric cards display:
- Transfer amount -- how much data has been sent so far.
- Elapsed time -- how long the transfer has been running.
Throughput Metrics
While the test is running, the screen shows detailed speed measurements:
- Current -- the transfer speed right now, in MB/s.
- Average -- the average speed over the entire test duration, in MB/s.
- Peak -- the highest speed reached during the test, in MB/s.
A real-time throughput graph plots the transfer speed over time, so you can see how performance varies during the test. Spikes and dips in the graph can reveal network congestion or interference.
Notes And Limitations
- Both devices must be running Lirum and have Throughput open at the same time.
- Transfer speed depends on network conditions, distance between devices, interference, and device hardware.
- Local Network permission is required on both devices. If permission is denied, peer discovery will not work.
- The test measures the speed of the peer-to-peer connection between the two devices, not your internet speed.
- Wi-Fi conditions, Bluetooth interference, and physical obstacles between devices can affect results.