nice-view-gem

A sleek customization for the nice!view shield

Add this shield to your keymap repo (see usage below) and run the GitHub action to build your firmware.

Features

• Uses a fixed range for the chart and gauge deflection. 📈
• Includes a beautiful animation for the peripheral of split keyboards. 💎
• Comes with pixel-perfect symbols for BLE and USB connections. 📡

Usage

To use this shield, first add it to your config/west.yml by adding a new entry to remotes and projects.

Important

Always pin both ZMK and this module to matching revisions.

• ZMK v0.3 → use release v0.3.0
• ZMK main (Zephyr 4.1+) → use the main branch

manifest:
  remotes:
    - name: zmkfirmware
      url-base: https://github.com/zmkfirmware
    - name: t3dodson #new entry
      url-base: https://github.com/t3dodson #new entry
  projects:
    - name: zmk
      remote: zmkfirmware
      revision: main
      import: app/west.yml
    - name: nice-view-gem #new entry
      remote: t3dodson #new entry
      revision: main #new entry
  self:
    path: config

Now, simply swap out the default nice_view shield on the board for nice_view_gem in your build.yaml file.

---
include:
  - board: nice_nano_v2
    shield: kyria_left nice_view_adapter nice_view_gem #updated entry
  - board: nice_nano_v2
    shield: kyria_right nice_view_adapter nice_view_gem #updated entry

Finally, make sure to enable the custom status screen in your ZMK configuration:

CONFIG_ZMK_DISPLAY=y
CONFIG_ZMK_DISPLAY_STATUS_SCREEN_CUSTOM=y

Configuration

Modify the behavior of this shield by adjusting these options in your personal configuration files. For a more detailed explanation, refer to Configuration in the ZMK documentation.

Option	Type	Description	Default
CONFIG_NICE_VIEW_GEM_WPM_FIXED_RANGE	bool	This shield uses a fixed range for the chart and gauge deflection. If you set this option to n, it switches to a dynamic range, like the default nice!view shield, which adjusts based on the last 10 WPM values provided by ZMK.	y
CONFIG_NICE_VIEW_GEM_WPM_FIXED_RANGE_MAX	int	Adjusts the maximum value of the fixed range to better align with your current goal.	100

Credits

Shoutout to Teenage Engineering for their TX-6, from which the inspiration (and maybe even a few pixel strokes) originated. 😬

As for the floating crystal, appreciation goes to the pixel wizardry of Trixelized, who graciously lent their art to this project. 💎

The font, Pixel Operator, is the work of Jayvee Enaguas, kindly shared under a Creative Commons Zero (CC0) 1.0 license. 🖋️