Skip to content

Releases

Shimmer 1.0.1

Choose a tag to compare

@kevinbpatel kevinbpatel released this 19 Nov 21:02

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

Choose a tag to compare

@kevinbpatel kevinbpatel released this 19 Nov 16:15

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