Workflow Improvements

.github/workflows/ci.yml

@@ -47,7 +47,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest]
+        os: [ubuntu-latest, windows-latest, macos-latest]
         python: ["3.12", "3.13"]
     steps:
       - uses: actions/checkout@v7
@@ -62,6 +62,12 @@ jobs:
         if: runner.os == 'Linux'
         run: bash scripts/linux/build/dependencies.sh
 
+      - name: Install system libraries (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          bash scripts/macos/build/dependencies.sh
+          bash scripts/macos/build/build_env.sh >> "$GITHUB_ENV"
+
       - name: Install the development environment
         run: uv sync --group dev
 

.github/workflows/workflow.yml

@@ -58,6 +58,10 @@ jobs:
         os: [ubuntu-latest, windows-latest, macos-latest]
         python: ["3.12", "3.13"]
     steps:
+      - uses: actions/checkout@v7
+        with:
+          path: repository
+
       - uses: actions/download-artifact@v8
         with:
           name: dist
@@ -74,10 +78,8 @@ jobs:
       - name: Install PortAudio (macOS)
         if: runner.os == 'macOS'
         run: |
-          brew install portaudio
-          prefix="$(brew --prefix portaudio)"
-          echo "CFLAGS=-I${prefix}/include" >> "$GITHUB_ENV"
-          echo "LDFLAGS=-L${prefix}/lib" >> "$GITHUB_ENV"
+          bash repository/scripts/macos/build/dependencies.sh
+          bash repository/scripts/macos/build/build_env.sh >> "$GITHUB_ENV"
 
       - name: Install the wheel and check the entry point
         shell: bash

.pre-commit-config.yaml

@@ -51,10 +51,18 @@ repos:
 
       - id: tag-names
         name: tag names
-        entry: uv run scripts/checks/tag_names.py
+        entry: uv run scripts/checks/tag_names.py --all
         language: system
         types: [python]
-        files: ^src/sampletones_application/tags/
+        pass_filenames: false
+        verbose: true
+
+      - id: palette-colors
+        name: palette colors
+        entry: uv run scripts/checks/palette_colors.py
+        language: system
+        files: (^src/sampletones_application/.*\.py|^src/sampletones_config/.*\.yaml)$
+        pass_filenames: false
         verbose: true
 
       - id: language-keys

CHANGELOG.md

@@ -4,6 +4,10 @@
 
 * Added support to [Bitphase](https://github.com/paator/bitphase).
 * Fixed arpeggio editing shifting a sample's pitch permanently.
+* Enhanced application options:
+    * Display settings
+    * Theme selector
+    * Keybinding settings
 * Bumped the reconstruction data-version to `2.1`.
 
 ## v0.3.0 [2026-07-31]

Makefile

@@ -1,6 +1,6 @@
 .PHONY: help setup install build release system-deps run clean pre-commit test \
 	ftm-samples check-import-boundary check-tag-names check-unused-tags \
-	check-language-keys calibration lint pylint mypy format
+	check-language-keys check-palette-colors calibration lint pylint mypy format
 
 ifeq ($(OS),Windows_NT)
 ifeq ($(MSYSTEM),)
@@ -43,12 +43,14 @@ endif
 BUILD_COMMAND := $(RUN_SCRIPT) $(BUILD_SCRIPT)
 RELEASE_COMMAND := $(RUN_SCRIPT) $(BUILD_SCRIPT) --release
 SYSTEM_DEPS_COMMAND := bash scripts/linux/build/dependencies.sh
+SETUP_ENV :=
 
 ifeq ($(UNAME_S),Darwin)
-	MACOS_SOURCE_ONLY := bash scripts/macos/source_only.sh
-	BUILD_COMMAND := $(MACOS_SOURCE_ONLY) 'make build'
-	RELEASE_COMMAND := $(MACOS_SOURCE_ONLY) 'make release'
-	SYSTEM_DEPS_COMMAND := $(MACOS_SOURCE_ONLY) 'make system-deps'
+	MACOS_NO_BUNDLE := bash scripts/macos/build/no_bundle.sh
+	BUILD_COMMAND := $(MACOS_NO_BUNDLE) 'make build'
+	RELEASE_COMMAND := $(MACOS_NO_BUNDLE) 'make release'
+	SYSTEM_DEPS_COMMAND := bash scripts/macos/build/dependencies.sh
+	SETUP_ENV := ARCHFLAGS="-arch $(shell uname -m)"
 endif
 
 GPU ?= auto
@@ -63,7 +65,7 @@ help:
 	@echo $(Q)Available targets:$(Q)
 	@echo $(Q)  make setup       - Set up development environment (uv); GPU auto-detected, GPU=0 forces CPU$(Q)
 	@echo $(Q)  make pre-commit  - Install pre-commit hooks$(Q)
-	@echo $(Q)  make system-deps - Install system packages required to build and run (Debian-based)$(Q)
+	@echo $(Q)  make system-deps - Install system packages required to build and run (Debian-based, or Homebrew on macOS)$(Q)
 	@echo $(Q)  make build       - Compile standalone executable (respects current deployment config)$(Q)
 	@echo $(Q)  make release     - Compile standalone executable with the release deployment config$(Q)
 	@echo $(Q)  make test        - Run unit tests with coverage$(Q)
@@ -74,8 +76,8 @@ help:
 	@echo $(Q)  make run         - Run SampleToNES application$(Q)
 
 setup:
-	uv sync --group dev $(if $(GPU_EXTRA),--extra $(GPU_EXTRA),)
-	uv tool install --force $(if $(GPU_EXTRA),".[$(GPU_EXTRA)]",.)
+	$(SETUP_ENV) uv sync --group dev $(if $(GPU_EXTRA),--extra $(GPU_EXTRA),)
+	$(SETUP_ENV) uv tool install --force $(if $(GPU_EXTRA),".[$(GPU_EXTRA)]",.)
 
 install:
 	$(MAKE) setup
@@ -118,6 +120,9 @@ check-unused-tags:
 check-language-keys:
 	uv run scripts/checks/language_keys.py
 
+check-palette-colors:
+	uv run scripts/checks/palette_colors.py
+
 calibration:
 	uv run scripts/calibration.py --all
 

README.md

@@ -57,11 +57,12 @@ To install with GPU support, request the `gpu` extra (see [GPU acceleration](#gp
 uv tool install "sampletones[gpu]"
 ```
 
-On Linux, audio playback and file dialogs rely on system libraries that cannot come from
-PyPI. Install them first:
+On Linux and macOS, audio playback and file dialogs rely on system libraries that come from
+the platform's package manager. Install them first:
 
 ```sh
 sudo apt-get install libportaudio2 libasound2 python3-tk    # Debian/Ubuntu
+brew install portaudio                                      # macOS
 ```
 ### Building the executable yourself