Broadcast · How-to
Stream tools how-to guide
From a fresh channel to a finished replay: grab your stream key, import the OBS profile, run an ingest check, go live, and wrap up with the post-stream handoff. For the full feature reference, see the Stream tools docs.
Before you start
- You’ll need to be signed in to your Aethera channel.
- Install OBS Studio (or any RTMP encoder). Everything else lives in the browser.
- Set up an authenticator app on your account — you’ll need it to rotate your stream key.
Get your stream key
- Open /stream-tools.html and find the Stream credentials section (your stream key also appears in Studio → Live at /dashboard?panel=live).
- Copy your RTMP server and stream key. Use Show to reveal the key, then Copy — do this now, because the key is shown only once and isn’t recoverable later.
- Need a new key? Click Rotate key and enter your 6-digit authenticator code. Rotating immediately invalidates the old key, so re-paste the new one into OBS.
Rotate your key any time you suspect it leaked. There’s no way to recover a lost key — just rotate to a fresh one.
Import the OBS profile
- On the Stream Tools page, click Download profile to get aethera-obs-profile.zip.
- Unzip it into your OBS profiles folder — on Windows that’s %APPDATA%\obs-studio\basic\profiles (the included README lists macOS and Linux paths too).
- In OBS, switch to the Aethera-RTMP profile and paste your stream key in place of the placeholder.
- Set up your scenes as usual — the video and encoder settings already match Aethera’s ingest defaults.
Prefer manual setup? Use the on-page 720p30 starter or 1080p60 high-motion presets as a starting point for your encoder.
Run your first broadcast
Walk the Go live wizard on the Stream Tools page top to bottom:
- Confirm credentials. Make sure your RTMP server and key are set in OBS.
- Run an ingest health check. Click Run check — wait for “online” before you start OBS output.
- Start streaming in OBS (“Start Streaming”).
- Watch the broadcast in the Live control room (/live-control-room.html): Stream health refreshes ingest, playback, bitrate, viewers, and last-segment age every 15 seconds.
- Open the chat pop-out for a clean moderation view on a second screen.
Set up replays
- Go to Studio → Live (/dashboard?panel=live).
- Under New replay visibility, choose Public, Unpublished, or Private — this is where auto-saved replays land after each stream ends.
- Click Save replay default. From now on, every stream is auto-archived as a replay with this visibility.
After the stream
When you stop streaming, Aethera archives the broadcast automatically. Finish up in the Live control room’s Post-stream handoff:
- Set the replay details — title and visibility — and upload a thumbnail (PNG, JPEG, or WEBP).
- Review your markers. Any markers you set during the stream become handy clip starting points.
- Cut highlights. Use Create replay clip with a start time and a duration (5–900 seconds) to carve out shareable moments.
Moderate chat & overlays
- Pop out chat. From Stream Tools, Open pop-out gives you a compact chat-only window for a second monitor.
- Tune chat. In the Live control room, set slow mode, blocked words, and emote-only / members-only / followers-only / auto-block-links toggles, then save. Time out or ban disruptive users from the same panel.
- Add a lower-third. Design an overlay (title, subtitle, accent color) and add it as a browser source in OBS.
Fix common problems
- Ingest check says offline. The RTMP edge isn’t reachable — wait a moment and re-run the check before starting OBS.
- Credentials didn’t load / key missing. Rotate to generate a fresh one-time key, then copy it into OBS.
- Lost your key. Keys can’t be recovered — rotate and re-paste the new one.
- Rotate is blocked. You’ll be sent to set up an authenticator app first; finish that, then rotate.
- Check service status at /status.html if something looks wrong platform-wide.