Repository navigation
Releases
Releases · slaughterhousesoftware/shimmer
Shimmer 1.0.1
Fixes to first-time setup and the Servers list.
Setup
- Pairing a PC from Nearby on the welcome page explains a failure instead
of returning to the page without a word (for example, when the code isn't
entered within 5 minutes). - Pairing again right after cancelling now says that Sunshine is still
holding the previous request (it clears within 5 minutes), instead of
"Pairing failed. Try again and approve the PIN on your PC". - The back button on a PC's or PS5's setup screen works. It sat on the
window's zoom button, which took its clicks. - The "Shimmer" title on the welcome page is sharp; it was blurred.
- Starting a new pairing clears the last attempt's message.
- Until a PC or PS5 is added, Shimmer opens its window on every launch, not
only the first, so quitting during setup no longer leaves only a menu bar
icon. - macOS's Local Network prompt mentions the PS5 as well as PCs.
Servers
- PCs and PS5s nearby that aren't added yet have the same round avatar as
added ones, in grey, on the Servers list, the welcome page and their setup
screens. - A nearby PC shows the Windows logo when it runs Windows, instead of
Linux's for any PC whose name doesn't say Windows or Mac. - Every system logo is centred to the pixel on its avatar, on Retina and
non-Retina screens alike. The Windows logo sat slightly left.
Download
- The disk image's window is light, so Finder's black "Shimmer" and
"Applications" labels are readable, and it no longer has a caption under
the arrow.
Source: this repo at tag v1.0.1 (GPLv3).
SHA-256:
0bf6c8278a1f8d8261f4f572ce5296b1d2c8cc9f93635dc5a37fe198632d28db Shimmer-1.0.1.zip
f302b1ce0fdbaccae93764d29856718b1ff3dabff7fad6b21e0c7469d8b114a9 Shimmer-1.0.1.dmg
Shimmer 1.0.0
The first Shimmer release: a Mac game-streaming client for PCs running
Sunshine and for the PS5, built around Picture in Picture and the DualSense.
Signed with Developer ID and notarized; installed copies update themselves.
Shimmer is a fork of glimmer 2026.9.0; glimmer's own history is further down
the changelog.
Picture in Picture
- ⌃⌥P, or Picture in Picture in the menu bar, moves the stream into macOS's
floating PiP window; it can also pop out automatically when you switch apps.
Controllers keep playing; the mouse over the PiP window drives the host
pointer. - Works around the AVKit sample-buffer PiP crop and black-overlay bugs
(Apple FB22411168), leaves no ghost Stage Manager tile, and waits for the
stream's first frame. - The stream can be screen-recorded and screen-shared from the Mac, and
Picture in Picture keeps playing while you record. glimmer hid the stream
from screen capture, which stopped the PiP picture when a recording began. - While you record, the PiP picture no longer stays frozen after a Stage
Manager switch or Mission Control. macOS 27.2 stops drawing a video layer
during those animations when the screen is being captured, and never
resumes on its own; Shimmer now redraws the PiP panel 20 times a second,
which restarts it. The half-second pause during the animation itself is
the system's - it holds every window on screen - and remains.
PlayStation 5
- Streams a PS5 over Remote Play through chiaki-ng's libchiaki, into the same
window, Picture in Picture, audio and controller path as a PC. A PS5 on the
network appears under Nearby; pairing takes a one-time PlayStation Network
sign-in and the code from Pair Device. Stream wakes it from rest mode, waits
out a console that is still releasing the previous session, and finds it
again if its address changes. - The DualSense gets the console's light bar, adaptive triggers and haptics;
touchpad and motion go back to the console. Over USB the haptics play on the
controller's actuators as the console sends them, through a buffer sized
from the stream's measured jitter (about 25 ms on a wired Mac). Over
Bluetooth they go in the controller's haptics report (DS5Dongle's layout,
after SAxense's research), sent the way P5M for Mac does: asynchronously,
a few at a time, with the controller at full motor power. macOS's Bluetooth
link carries about 33 reports a second on a MacBook, so dense effects can
lose some blocks; short ones come through whole. The console's vibration and trigger-effect
intensity settings apply.
Controllers
- Adaptive triggers now work (checked on a USB DualSense against the pad's own
trigger-status report). Shimmer's DualSense output report was missing its
report ID, so the controller ignored it, and lacked the bits that let
trigger effects apply. PC streams send their trigger effects through the
same report.
Wi-Fi
- "Reduce lag spikes on Wi-Fi" is back, without the background helper: the
first time, macOS asks for your password once to allow Shimmer to pause
AirDrop's Wi-Fi link (awdl0), which it does only while a stream runs over
Wi-Fi, restoring it afterwards.
One window
- Servers, General, Controller and About tabs replace the launcher and the
separate Settings window, laid out like a native Mac utility. - Servers lists your PCs and PS5s and the ones nearby, pairs them in place,
and holds each machine's stream settings. Add by Address takes a PC's or a
PS5's IP address or hostname and works out which it is. PCs can show a
Linux, Windows, SteamOS or macOS logo. - Settings are grouped with clear labels, descriptions and native buttons;
the scrolling pages size the window to their content.
Menu bar
- The icon shows the connected controller and its battery, drawn after
Steam's controller glyphs, or the app you're streaming; a pyramid spinner
while connecting. - The menu is a Liquid Glass panel: the app on the selected server with
Stream, Picture in Picture and End Stream, the stream volume, and each
server's resolution, frame rate, bitrate and HDR, which unfold in place.
Streaming and input
- End Stream disconnects and leaves the game running; "Quit the game when the
stream ends" ends it on the PC instead. - Mouse Off (in the menu) stops forwarding the mouse and never grabs the
pointer. The Mac stays awake while a stream runs. - A PC's manual address (for example its Tailscale address) is used when the
home address isn't reachable. A stream dropped by sleep or a network change
no longer leaves a stale error. - "Prefer low audio latency" caps the audio playout cushion at 60 ms. Colour
on SDR displays is no longer over-saturated. - "Game Mode while streaming" raises Bluetooth controller polling, so input
arrives about twice as fast. - Less CPU at high bitrates: finding the frame boundaries in the incoming
video was the largest cost in the app at ~190 Mbps, and now skips most of
the bytes it used to read. - The app no longer pauses its main thread for ~28 ms every two seconds to
ask macOS whether the login item is registered.
Tools
shimmerctl: check connectivity, read logs and run test streams, locally
or on another Mac over SSH (docs/CLI.md).
Removed
- glimmer's root Wi-Fi helper daemon (see Wi-Fi above for its replacement).
If an earlier build registered it, the first launch marks it unregistered.
Ported from later glimmer releases
- Identity storage never reads or deletes Keychain items (glimmer 8aaaaa5).
- AV1 from AMD encoders, which pad 1080p to 1082 rows, decodes instead of
failing (glimmer Se7enbrc#223 / Se7enbrc#224). AV1 sequence headers that carry
decoder-model info are read correctly. - A DualSense is announced to the PC before any of its input, so Sunshine
creates a PlayStation pad with a working touchpad, not an Xbox 360 pad
(glimmer Se7enbrc#217). - Video and audio are accepted only from the paired PC's address.
- Logs you copy or share, and
shimmerctl's view of them, hide PC names,
addresses and error details; telemetry names machines by a per-install
pseudonym. - Audio: a packet that won't decode is concealed instead of dropped, the
playout cushion recovers from under-runs without over-growing (gaps no
cushion could bridge no longer count), audio FEC survives a misaligned
parity packet, and malformed datagrams are dropped before they can reorder
playback. - Video and pacing: key frames led by AUD/SEI units open the recovery gate,
frames lost after a dropped FEC block are reported, a failed FEC rebuild is
never sent as a frame with a hole in it, a frame standing above the pacer's
target is trimmed, a due frame is released straight from submit, and a
vsync is never claimed twice. Fewer allocations per packet. - Recovery: keyframe requests back off during a stall and are spaced by the
round trip, a stream that receives but never decodes rebuilds once after
30 s, every RTSP wait is bounded, quitting mid-reconnect still ends the game
on the PC, a game the PC deliberately ended isn't relaunched, a bitrate
downshift can step back up, and control messages are delivered in order.
Source: this repo at tag v1.0.0 (GPLv3).
SHA-256:
142536d2fd1c6f4e9617260c75c2b7b9be1136188cc71608e299ab77c511c6ae Shimmer-1.0.0.zip
90bed48c50355819d82f5384add179fcebd203ba3f94d8bec94b73cd181daaa9 Shimmer-1.0.0.dmg