Skip to content
j2k-labPublic

About

kickNX - Kick for Nintendo Switch

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

kickNX

A controller-first Kick client for Nintendo Switch homebrew.

Release 0.5.2 Downloads Nintendo Switch C++17 License GPL-3.0

Created by j2k

About

kickNX is an independent Kick client built specifically for Nintendo Switch homebrew. It combines native playback, Kick browsing and interactive chat in an interface designed around Joy-Con, Pro Controller and touchscreen use in handheld, tabletop and television play.

Version 0.5.2 adds Kick's Daily Reward: a progress bar above chat, claiming from the player or a gift button on Home, and a look at the collectible you got. Emotes are split into Channel, Global and Collectibles tabs, with subscriber emotes when you are subscribed. It also keeps chat and video steady through brief Wi-Fi drops, so Airplane mode is no longer needed to recover. Version 0.5.1 lets you rewind a live stream all the way back to its start, the way kick.com does, by switching to the live VOD. It also installs updates from the About page and restarts on its own, shows how to launch kickNX properly when it is opened in applet mode, and speeds up Home, chat and playback. Version 0.5.0 added colour themes (OLED, Dark Grey and Kick) chosen from a pop-up on Home, a Live events row and event pages with live streams and popular clips, and an in-app keyboard for landscape chat. It also removed the non-Kick features to make kickNX Kick-only. It also includes channel follow and unfollow directly from streamer profiles, custom 3D kickNX buffering indicator with lime text shimmer, clickable user avatar navigation, Kick-green section divider lines and tabs, Kick TV QR code pairing, Kick-styled playback controls with live stream uptime, channel category navigation, bottom-sheet emote composer, real-time Pusher chat, and Joy-Con portrait mode.

Screenshots

Home Live stream with chat overlay
Home Live stream with chat
Theme picker Live event page
Theme picker Live event page
Channel page QR code sign-in
Channel page QR code sign-in
In-app chat keyboard Emote picker
In-app chat keyboard Emote picker
About page Daily Reward window
About and update check Daily Reward

Portrait mode keyboard   Portrait mode emotes

Portrait mode with chat, keyboard and emotes

Features

Browse Kick

  • Built-in Kick account sign-in
  • Transparent 3D kickNX brand header logo on Home and About pages
  • Interactive top-right profile avatar navigating directly to your channel
  • Followed live channels row
  • Live events row, with event pages showing the event's live streams and most-viewed clips
  • Popular streams, top categories and live search by channel or game
  • Current viewer counts in live search results
  • Controller-friendly horizontal rows with pagination
  • Channel artwork, stream thumbnails and account information

Channel pages

  • Centered header presentation with prominent profile picture, stream title, live status, metadata, and action buttons
  • Touch-friendly < Back button on the top left for quick touchscreen navigation
  • Live/offline status, banner, profile artwork and description
  • Direct channel follow and unfollow with real-time status detection and sync
  • Current stream and category information
  • Recent broadcasts and clips; a broadcast that is still live shows as a "LIVE now" card that opens the live stream
  • Direct live, VOD and clip playback

Playback

  • Native Kick live-stream, VOD and clip playback
  • Rewind a live stream back to its start: short rewinds stay in the live buffer (about 30 seconds), longer ones switch to the live VOD with chat staying live, and scrubbing to the end of the bar goes back to live
  • While scrubbing, a small label over the progress bar shows how far behind live (or, in a VOD, which time) you are going
  • Custom 3D kickNX buffering indicator with animated lime-green letter shimmer and neon progress track
  • Source and transcoded quality selection (1080p60 default)
  • Embedded-player live resolution that avoids the generic commercial-break slate
  • Software, hardware and Hybrid decoder modes
  • Decoder changes apply immediately to the active live stream
  • Hardened MPV/FFmpeg/NVTEGRA hardware-frame handling
  • Fullscreen, docked-chat and overlay-chat layouts
  • Stream title shown at the top of the live player controls
  • Live streams do not create unnecessary MPV watch-later files

Portrait mode

  • Automatic landscape and portrait detection from either attached Joy-Con
  • Clockwise and counter-clockwise portrait orientations
  • Manual orientation choices when sensor control is unavailable
  • Rotated 720 x 1280 touch surface with corrected touch coordinates
  • Stream, live chat, persistent message draft and inline keyboard on one screen
  • Dedicated Emotes key on the portrait keyboard opening a portrait-proportioned Kick emoji composer with Recent and All tabs
  • Touch keyboard/emote-sheet switching from the draft field or < Keyboard button
  • Adjustable touch-keyboard haptic feedback

Live chat

  • Read and send Kick chat messages
  • Kick username colors and formatted chat messages
  • Global, channel, subscriber and exclusive emotes
  • Static and animated Kick emotes
  • Message composer with a built-in on-screen keyboard (Caps Lock, symbols) and Recent, Channel, Global and Collectibles emote tabs
  • Subscriber emotes in the Channel tab when you are subscribed
  • Daily Reward progress bar above chat, with claiming from the player or the Home gift button
  • Touch-accessible Send button in the full composer
  • Optional Nintendo system keyboard under Player Settings → Message composer
  • Multi-line message wrapping
  • Docked chat, full-height overlay and compact overlay
  • Four-corner overlay placement and configurable width

Controller-first interface

  • D-pad and left-stick focus navigation with Kick bright green hover highlights
  • OLED true black backgrounds across streamer profiles and About pages
  • OLED, Dark Grey and Kick colour themes; Kick pairs a muted green page with a dark "K" pattern on headers and the sign-in screen
  • Right-stick scrolling on long pages
  • Handheld, portrait and television-friendly layouts
  • Dedicated About page with features, credits and complete release history

Installation

  1. Download the latest release from the kickNX Releases page.

  2. Extract the release so the SD card contains:

    /switch/KickNX/kickNX.nro
    
  3. Launch kickNX from the Nintendo Switch Homebrew Menu.

  4. Complete the built-in Kick sign-in process.

No legacy configuration file is required. The client configures playback settings automatically through the in-app settings menu.

Updating

On the About page, Check for updates downloads a newer release, installs it and restarts kickNX. kickNX is also in the Homebrew App Store. To update by hand, replace the existing NRO in /switch/KickNX/ with the newer release. OAuth, chat, decoder, orientation and interface preferences remain under /config/KickNX/ and are not stored inside the executable.

Decoder modes

  • Software: compatibility mode using CPU video decoding.
  • Hardware: NVTEGRA decoding with the validated kickNX frame, reference and transfer guards.
  • Hybrid: starts in hardware and can use software recovery during a disruptive playback transition.

The embedded-player resolver prevents the generic Kick commercial presentation from entering the player in current testing, greatly reducing the discontinuities that previously stressed hardware decoding.

Known limitations

  • Some standard Unicode emoji characters may render as missing-glyph boxes.
  • Subtitle tracks in Player Settings remain inactive until Kick updates their Amazon IVS backend to serve live transcode tracks (Kick's web player currently relies on client-side browser speech recognition).
  • Kick may change its undocumented playback-token behavior without notice.
  • Rewinding further than the live buffer needs a live VOD. Channels that don't save their broadcasts can only rewind about 30 seconds. The first long rewind briefly stops the stream while kickNX fetches the live VOD.
  • Automatic portrait detection requires at least one compatible attached Joy-Con; manual orientation remains available from player settings.

Building from source

See BUILDING.md for the guarded FFmpeg 7.1/NVTEGRA recipe, the Docker build image and Nintendo Switch build commands.

Quick build with Docker after the guarded FFmpeg is prepared:

docker build -t kicknx-switch-builder .
docker run --rm -v "${PWD}:/workspace" -w /workspace kicknx-switch-builder bash build-switch.sh

The generated executable is:

build_switch/kickNX.nro

Project history

Major milestones:

  • 0.1.0 - Initial native kickNX release ported from twiNX with guest browsing and controller navigation
  • 0.2.0 - Real-time Pusher WebSocket live chat, Kick emotes, and streamer channel pages
  • 0.3.0 - TV QR code login, live AWS IVS master playback, 60 FPS presentation, and fast VOD streaming
  • 0.3.1 - Fast VOD/clip launch, active chatter counter, and WebVTT subtitle track selection
  • 0.3.2 - Kick signature playback bar with live uptime, channel category navigation, and bottom sheet emote composer
  • 0.4.0 - Channel follow/unfollow on streamer profiles, clickable user avatar, and Kick bright green UI theme, plus chat, playback and settings fixes
  • 0.5.0 - Colour themes with a Home pop-up picker, Kick-only cleanup, offline stream handling and playback fixes
  • 0.5.1 - Rewind live streams to their start through the live VOD, in-app updates with automatic restart, applet-mode launch help, and faster Home, chat and playback
  • 0.5.2 - Daily Reward progress and claiming, Channel, Global and Collectibles emote tabs with subscriber emotes, and steadier chat and video through Wi-Fi drops

See CHANGELOG.md for the full release history.

Credits

  • j2k - kickNX creator and developer
  • Gemini - AI co-development partner
  • Claude - AI co-development partner
  • twiNX developer HiroshiYamauchi - upstream client foundation
  • Switchfin contributors - original Nintendo Switch UI/player/platform base
  • Borealis contributors - controller-first UI framework
  • Twire contributors - reference behavior for embedded-player resolution
  • mpv, FFmpeg, libcurl, LunaSVG, libnx and devkitPro contributors

Full attribution is available in THIRD_PARTY_NOTICES.md.

License

The combined kickNX project and its original kickNX-specific code are distributed under GPL-3.0-only. Inherited and third-party files retain their original licenses and copyright notices. See LICENSE, LICENSES and THIRD_PARTY_NOTICES.md.

Disclaimer

kickNX is an independent, unofficial homebrew project. It is not affiliated with, endorsed by or sponsored by Kick, Amazon or Nintendo. Product names and trademarks belong to their respective owners.

About

kickNX - Kick for Nintendo Switch

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages