Need help with QuietModemKit?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
quiet

Description

iOS framework for the Quiet Modem (data over sound)

414 Stars 37 Forks BSD 3-Clause "New" or "Revised" License 48 Commits 17 Opened issues

Services available

Need anything else?

QuietModemKit

This is the iOS framework for https://github.com/quiet/quiet

With this library, you can send data through sound.

Live demo: https://quiet.github.io/quiet-js/

Other platforms: * Javascript: https://github.com/quiet/quiet-js * Android: https://github.com/quiet/org.quietmodem.Quiet

Why sound? Isn't that outdated?

If you are old enough, you may remember using dial-up modems to connect to the internet. In a sense, this package brings that back. While it's true that this is somewhat of a retro approach, consider the advantages of using sound.

  • Highly cross-platform. Any device with speakers and a microphone and sufficient computational power can use this medium to communicate.

  • No pairing. Unlike Bluetooth, sound can be used instantly without the need to pair devices. This reduces the friction and improves the user experience.

  • Embeddable content. Similar to a QR code, short packets of data can be encoded into streaming or recorded audio and can then be later decoded by this package.

What does it sound like?

The answer to this depends on which operating mode you choose. Quiet provides audible and near-ultrasonic modes. Audible modes sound something like a puff of air. The near-ultrasonic modes run at 17+kHz and are virtually inaudible to adults. Either mode can operate at relatively low volumes as long as there isn't too much background noise.

How fast does it go?

Quiet's provided audible mode transfers at approximately 7kbps. In cases where two devices are connected over a cable (via 3.5mm jack) it can run in cable mode, which transfers at approximately 64kbps.

Building

CMake is required to build QuietModemKit. If you aren't sure if you have CMake installed, run

brew install cmake
.

It is recommended that you use Carthage to build QuietModemKit. Simply run

brew install cmake
and then add
github "Quiet/QuietModemKit"
to your Cartfile and run
carthage update
.

Example

Transmitter: ```objc

import

int main(int argc, char * argv[]) { QMTransmitterConfig *txConf = [[QMTransmitterConfig alloc] initWithKey:@"ultrasonic-experimental"];

QMFrameTransmitter *tx = [[QMFrameTransmitter alloc] initWithConfig:txConf];

NSString *frame_str = @"Hello, World!"; NSData *frame = [frame_str dataUsingEncoding:NSUTF8StringEncoding]; [tx send:frame];

CFRunLoopRun();

[tx close];

return 0;

}

Receiver:
```objc
#import 

static QMFrameReceiver *rx;

void (^recv_callback)(NSData*) = ^(NSData *frame){ printf("%s\n", [frame bytes]); };

void (^request_callback)(BOOL) = ^(BOOL granted){ QMReceiverConfig *rxConf = [[QMReceiverConfig alloc] initWithKey:@"ultrasonic-experimental"]; rx = [[QMFrameReceiver alloc] initWithConfig:rxConf]; [rx setReceiveCallback:recv_callback]; };

int main(int argc, char * argv[]) { [[AVAudioSession sharedInstance] requestRecordPermission:request_callback];

CFRunLoopRun();

if (rx != nil) {
    [rx close];
}

return 0;

}

Note that we ask for the Record permission. This is required to use the receiver.

Profiles

The modem can be used audibly or via ultrasonic sound.

QMTransmitterConfig
and
QMReceiverConfig
are used to select modem configuration. For a full list of valid keys, refer to the top-level keys of quiet-profiles.json.

License

3-Claused BSD, plus third-party licenses (mix of MIT and BSD, see licenses/)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.