Moblin - IRL Streaming

A free iOS app for IRL streaming. Mainly targeting Twitch, but can stream to YouTube, Kick, Facebook and OBS Studio as well (and probably more).

Discord: https://discord.gg/nt3UwHqbMM

Github: https://github.com/eerimoq/moblin

TestFlight: https://testflight.apple.com/join/PDpxEaGh

Features

• Stream using RTMP, RTMPS, SRT or SRTLA to any platform that supports them.
• H.264/AVC and H.265/HEVC video codecs.
• Up to 4K resolution and 60 FPS.
• SRTLA.
  • Can use one cellular, one WiFi and multiple Ethernet connections simultaneously. Often called bonding.
  • Upload statistics per active connection.
• Twitch integration.
  • Number of viewers.
  • Chat.
    • Announcements.
    • /me styling.
• Kick integration.
  • Chat.
• YouTube integration.
  • Scuffed chat.
• AfreecaTv integration.
  • Scuffed chat.
• Basic scenes.
  • Image widget. Show an image on stream.
  • Time widget. Show local (phone) time on stream.
  • Browser widget. Show a web page on stream.
• Back or front camera.
  • Front camera mirrored on screen for natural experience.
• Back, front, bottom or external mic.
  • Automatically changes to external mic when connected.
• Video stabilization.
• Zoom.
  • Pinch-to-zoom.
  • Configurable presets.
• Back camera lens selection.
• Record to disk (MP4-file).
  • Configurable bitrate, video codec and key frame interval.
• RTMP server/ingest as camera source.
  • Only supports video. No audio (yet).
  • Optionally fixed FPS.
• Localization. Supports many languages, for example English, French, German, Spanish, Polish, Chinese (Simplified) and Swedish.
• Tap screen for manual focus.
  • Return to auto focus with long press.
• Stream connection status and uptime.
• OBS WebSocket (remote control)
  • See current scene, streaming state and recoring state.
  • Change scene.
  • Start and stop the stream.
  • Snapshot.
  • Audio levels.
  • Set audio sync.
• Make phone screen black by pressing a button.
• Supports UVC cameras on iPad.
• Basic support for Mac.
• Video effects.
  • Grayscale.
  • Movie. Paint top and bottom of 16:9 video black to look like 2.35:1.
  • Seipa.
  • Noise reduction.
  • Random. A single effect that applies a random effect.
  • Triple. Show center of image three times. Experimental.
• Chat styling.
  • Colors, background, border and bold.
  • Twitch, Kick, BTTV, FFZ and 7TV emotes.
  • Optionally animated emotes.
  • Optionally remove old messages.
  • Width and height.
  • Optional message timestamp.
• Battery indicator.
  • Charging icon.
  • Optionally with percentage.
• Game controllers for remote control.
  • Zoom in and out.
  • Change scene.
  • Torch.
  • Mute.
  • ...
• Cosmetics.
  • Select Moblin icon to show in app and on home screen.
  • Optionally purchase additional Moblin icons to support developers.
• Configure stream resolution, FPS, video codec, bitrate and more.
• Configurable bitrate presets.
• Adaptive bitrate for SRT(LA).
• Optionally remote control the streamer's Moblin app over the network.
  • Shows basic status information.
  • Change scene.
  • Change mic.
  • Change bitrate.
  • Change zoom.
  • Show logs.
• Torch.
• Mute audio.
• Deep link settings (moblin://).
• Landscape only.
  • Both 0 and 180 degrees orientation. Video always with gravity down (never upside down).

ToDo

Ideas/plan

• Show two cameras at the same time.
• Rework zoom. Fine tune similar to builtin camera app.
• Audio filters. For example volume limiter.
  • An adjustable gain would be nice, then limiter (to keep audio from clipping), and a noise gate would be my top 3 requested audio filters when you have the time. I think that would be the same order in terms of complexity to implement as well.
• Reduce brightness when thermal state is critical.
• Add Twitch/Kick Icons next to chat messages depending on which platform the message came from.
• Lookup Twitch channel id from channel name. Possibly login to Twitch.
• Something that is important for professional streamers: Ad management. There are new endpoints to get and snooze the next ad schedule. No app uses it afaik yet.
  • https://dev.twitch.tv/docs/api/reference/#get-ad-schedule

Import settings using moblin:// (custom URL)

An example creating a new stream is

moblin://?{"streams":[{"name":"BELABOX%20UK","url":"srtla://uk.srt.belabox.net:5000?streamid=9812098rh9hf8942hid","video":{"codec":"H.265/HEVC"},"obs":{"webSocketUrl":"ws://123.22.32.112:5465","webSocketPassword":"foobar"}}]}

where the URL decoded pretty printed JSON blob is

{
  "streams": [
    {
      "name": "BELABOX UK",
      "url": "srtla://uk.srt.belabox.net:5000?streamid=9812098rh9hf8942hid",
      "video": {
        "codec": "H.265/HEVC"
      },
      "obs": {
        "webSocketUrl": "ws://123.22.32.112:5465",
        "webSocketPassword": "foobar"
      }
    }
  ]
}

Format: moblin://?<URL encoded JSON blob>

The MoblinSettingsUrl class in MoblinSettingsUrl.swift defines the JSON blob format. Class members are JSON object keys. Members with ? after the type are optional. Some types are defined in Settings.swift.

Ideas

Examples of text widgets

Default SRT stats

Configured text:

{srtStats}

Rendered on stream:

pktRetransTotal: 524
pktRecvNAKTotal: 203
pktSndDropTotal: 2
msRTT: 42.47
pktFlightSize: 12
pktSndBuf: 2

Clock

Configured text:

{clock}

Rendered on stream:

12:32:51

Clock and two SRT stats

Configured text:

clock: {clock}
msRTT: {srtStatsMsRtt}
pktFlightSize: {srtStatsPktFlightSize}

Rendered on stream:

clock: 12:32:51
msRTT: 33.1
pktFlightSize: 3

Similar software

• https://irlpro.app/
• Twitch app.
• https://softvelum.com/larix/ios/