Skip to content
CAI
Software that uses CAICheck a score

finamp-app/finamp

45.1

Weak · 12 November 2026

64.5k

lines of production code

Dart

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add app icon assets and Linux icon generation script

This change introduces the source SVG assets for the application icon (including foreground, square, and white variants) and adds a shell script to automatically generate Linux desktop icons in various sizes. This ensures consistent branding across the Linux desktop environment by providing the necessary source files and tooling to produce the required icon sets.

assets/icon · high confidence

Add dedicated message for missing music libraries

A new component has been introduced to display a specific message when no music libraries are available. This UI element presents a localized title and body text, along with a refresh button, allowing users to understand the current state and attempt to resolve the issue.

lib/components/ViewSelector · high confidence

Add global keyboard shortcuts for music playback controls

Users can now control music playback using global keyboard shortcuts, including Space to toggle play/pause, Ctrl+N/P to skip tracks, Ctrl+Left/Right to seek, Ctrl+Up/Down to adjust volume, Ctrl+L to toggle loop mode, Ctrl+S to toggle shuffle, Escape to go back, and F11 for fullscreen. These shortcuts are registered globally via a new shortcut manager and are designed to work even when text fields are focused for most actions, with visual feedback provided via snackbars for actions like skipping tracks or changing loop/shuffle modes.

lib/components/Shortcuts · high confidence

Add local network address preference and auto-offline settings

The Network Settings screen now includes controls to prefer a local network address over the public one, allowing users to toggle this preference and edit the local address directly. It also introduces an auto-offline selector to automatically switch the app to offline mode based on network conditions (off, network, disconnected, unreachable). Additionally, a display component shows the currently active network address.

lib/components/NetworkSettingsScreen · high confidence

Add tab visibility toggle with drag handle support

A new toggle component has been added to the Tabs Settings screen, allowing users to show or hide specific tabs (such as performing or album artist tabs) via a switch. Each toggle includes a drag handle, enabling users to reorder the tabs directly within the settings interface.

lib/components/LayoutSettingsScreen/TabsSettingsScreen · high confidence

Added Arabic, Bengali, and other language translations

The app now supports Arabic, Bengali, and several other languages, with new translation files added to the localization system. This expands the app's internationalization coverage, allowing users to interact with the interface in their preferred language.

lib/l10n · high confidence

Added Flathub packaging assets for Finamp

Added the AppStream metainfo file (assets/com.unicornsonlsd.finamp.metainfo.xml) and the m4 template for the desktop entry (assets/finamp.desktop.m4) to support Linux distribution via Flathub. The metainfo defines the application metadata, including screenshots, supported controls, and release history for versions up to 1.0.1-beta, while the desktop template configures the application ID, icon, and MIME type handling for the custom 'finamp' URL scheme.

assets · high confidence

Added Linux Flutter build configuration and plugin registrant

The Linux build system now includes the standard Flutter engine integration files. A new CMakeLists.txt configures the build to link against the Flutter Linux GTK library and its required system dependencies (GTK, GLib, GIO), while a generated header file provides the entry point to register Flutter plugins on Linux.

linux/flutter · high confidence

Added code\_recap tool for generating project statistics

A new Python-based tool in \tools/code\_recap\ has been added to generate yearly recaps and translation statistics. It consists of \extract\_history.py\, which parses git commit history (including optional GitHub username resolution and merge detection), and \recap.py\, which processes this data to produce a markdown report. The report includes metrics such as commit counts, additions/deletions, pull request statistics, and rankings of new and all-time code authors and translators.

tools · high confidence

Automated settings accessors and providers via code generation

A new build-time code generator in lib/builders automatically creates typed setters and Riverpod selectors for fields in FinampSettings, simplifying how users read and update configuration values. The generator respects @SettingsHelperIgnore to exclude specific fields and uses @SettingsHelperMap to generate granular, per-key selectors for Map fields, ensuring that UI updates only trigger when the specific setting changes.

lib/builders · high confidence

Dedicated Genre Screen with curated item sections and filtering

A new dedicated Genre Screen has been introduced, replacing the previous generic music screen view for genres. This screen organizes content into distinct curated sections for tracks, albums, and artists, each displaying item counts and supporting specific sorting and filtering options (such as Most Played, Favorites, or Latest Releases). Users can tap on these sections to view all items of that type within the genre, with inherited sorting and filtering settings. The interface includes filter chips to toggle between curation types and handles empty states by automatically switching to the next available filter if enabled, ensuring a seamless browsing experience for genre-specific content.

lib/components/GenreScreen · high confidence

Finamp 1.0.0 release with native splash screens and dynamic theming

Finamp is now available as version 1.0.0 on the Google Play Store, Apple App Store, and F-Droid. This release introduces native splash screens for light and dark modes, dynamic accent colors based on the current track and device theme, and colored monochrome in-app icons. It also includes Android Auto and CarPlay support, lyrics support, and integration with AudioMuse for sonic analysis.

(repo-wide) · high confidence

Generated asset accessors for images and icons

The application now includes a generated Dart file that provides type-safe accessors for bundled image assets, including album art, app icons, and the Jellyfin logo. This allows the UI to reference these resources through a structured API rather than raw string paths.

lib/gen · high confidence

Initial Linux desktop support for Finamp

Finamp now includes a native Linux desktop application, allowing users to run the service on Linux systems. This release adds the necessary CMake build configuration, a custom GTK application wrapper (replacing the generic Flutter runner), and integration with system libraries like GTK and D-Bus to handle window management and command-line arguments.

linux · high confidence

Initial macOS platform support added

The macOS platform is now supported, introducing the native Xcode project structure, build configurations, and entitlements required to run the application on macOS. This includes the main application entry point (AppDelegate) which handles custom URL schemes via the app\_links plugin, a standard macOS menu bar interface, and the necessary asset catalogs for the application icon. The configuration also sets the bundle identifier to com.unicornsonlsd.finamp and defines the 'finamp' URL scheme for deep linking.

macos · high confidence

Logs screen rework: export, copy, share, and verbose logging toggle

The Logs screen now includes dedicated buttons to copy, export, and share logs, along with a toggle to enable verbose logging at runtime. Log entries are displayed in expandable tiles that censor login information by default, requiring explicit user confirmation to view uncensored messages, and support long-press or secondary-tap to copy individual log messages to the clipboard.

lib/components/LogsScreen · high confidence

New Playback History screen with grouped tracks, favorites, and offline log sharing

A new Playback History screen has been added, displaying recently played tracks grouped by date with relative time labels. Each history item is a track tile that shows the album art, title, artist, duration, and playback progress percentage, and includes a favorite button for quick toggling. Long-pressing or right-clicking a track opens the standard track menu. The screen also includes a button in the header to export and share the offline listens log file via the system share sheet.

lib/components/PlaybackHistoryScreen · high confidence

New Volume Normalization settings UI components

The Volume Normalization Settings screen now includes dedicated UI components for managing volume normalization: a switch to enable/disable the feature, a dropdown selector for choosing the normalization mode (hybrid, track-based, album-based, or album-only), and an iOS-specific editor for adjusting the base gain value. These components replace previous implementations and integrate with the localized settings system.

lib/components/VolumeNormalizationSettingsScreen · high confidence

New album image caching and album/playlist track providers

The app now uses a dedicated \AlbumImageProvider\ to cache and serve album artwork, improving image loading performance and reducing redundant network requests. Additionally, new Riverpod providers (\getAlbumOrPlaylistTracks\, \getSortedPlaylistTracks\) have been introduced to manage album and playlist track lists, supporting both online and offline modes with proper sorting and filtering capabilities.

lib/services · high confidence

New custom button components with haptic feedback and adaptive styling

The app introduces a new set of reusable button widgets in the \lib/components/Buttons\ directory, including \CTAHuge\, \CTALarge\, \CTAMedium\, \CTASmall\, \FinampExtendedFloatingActionButton\, and \SimpleButton\. These components replace generic Flutter buttons with a consistent design language that adapts to light and dark themes, supports optional vertical layouts, and provides haptic feedback via \FeedbackHelper\ on user interaction. The \SimpleButton\ component adds granular control over icon positioning, secondary press actions, and inactive states, while the CTA (Call-to-Action) buttons offer varied sizes and styling for different UI contexts.

lib/components/Buttons · high confidence

New dedicated menus for albums, artists, genres, and collections

The app now includes specific bottom-sheet menus for Albums, Artists, Genres, and Collections, each providing context-appropriate actions such as starting radio, building instant mixes, adding to playlists, and managing downloads. These menus also feature a unified PlaybackActionRow at the top for quick playback controls. Additionally, a new menu has been added for configuring Home Screen sections, allowing users to edit section settings and manage downloads for specific presets. A new client certificate authentication menu simplifies the import and management of mTLS certificates, and the output menu now includes an AirPlay picker for iOS/macOS and disables volume controls when AirPlay is active.

lib/menus · high confidence

New download location selection forms for app and custom directories

Users can now choose where to store downloads via two new forms: one that lists available external storage directories on mobile devices, and another that allows manual selection of a custom directory path using a file picker. Both forms include validation to ensure a location is selected and a name is provided, and they update the download location settings accordingly. A warning is displayed for custom locations on iOS and Android due to potential platform restrictions.

lib/components/AddDownloadLocationScreen · high confidence

New interaction and queue persistence settings

The Interaction Settings screen now includes controls for customizing swipe actions on items (left-to-right and right-to-left), toggling the auto-expansion of the player screen, and enabling a fast scroll indicator. Additionally, users can configure how the 'previous tracks' section behaves in the queue bottom sheet via a new persistence mode dropdown (persistent, initially collapsed, or initially expanded), and adjust screen-keep-alive options such as keeping the screen on while charging.

lib/components/InteractionSettingsScreen · high confidence

New layout and appearance settings in LayoutSettingsScreen

The LayoutSettingsScreen now includes controls for customizing the app's visual theme and layout. Users can select a custom accent color via a new color picker, toggle an AMOLED theme for deeper blacks, and enable system accent color support on compatible platforms. Additional layout options allow users to control whether album covers are used as backgrounds, adjust the minimum cover padding on the player screen, choose whether to display text on the grid view, and toggle the display of artist chip images.

lib/components/LayoutSettingsScreen · high confidence

New menu components and radio mode controls

The menu system now uses a new \IconButtonWithSemantics\ widget for improved accessibility and consistent interaction handling, including long-press support. A dedicated \RadioModeMenu\ has been added, allowing users to select and toggle radio playback modes (such as similar or shuffle) with clear availability status indicators and offline handling. Additionally, a \SpeedMenu\ component provides playback speed adjustment via preset chips and a slider, while \MenuItemInfoHeader\ standardizes how item details (like album art and artist info) are displayed in menu headers across different content types.

lib/menus/components · high confidence

New reusable UI components for the Settings screen

The Settings screen now uses three new shared components to improve consistency and user experience. FinampSettingsDropdown provides a standardized, styled dropdown menu for selecting settings options. SubtitleWithMoreInfoDialog adds a tappable 'more info' link to setting descriptions, opening a detailed dialog when tapped. LogoutListTile handles the user logout process, including a confirmation dialog, clearing the playback queue, and navigating back to the splash screen, while also disabling the option in offline mode.

lib/components/SettingsScreen · high confidence

New settings for PlayOn, Discord RPC, and playback reporting

The Playback Reporting Settings screen now includes controls for several new features. Users can enable or disable Discord RPC and choose a custom icon for it. A new toggle allows enabling PlayOn, which automatically enables queue reporting to the server. Additionally, users can configure the PlayOn reconnection delay and stale delay, as well as the frequency for periodic playback session updates.

lib/components/PlaybackReportingSettingsScreen · high confidence

New settings for playback speed control visibility and tile additional info types

The CustomizationSettingsScreen now includes dedicated UI components for configuring playback speed control visibility and tile additional information types. Users can select when the playback speed control appears via a dropdown that localizes the \PlaybackSpeedVisibility\ options and displays detailed help text. Additionally, a new dropdown allows users to choose which metadata (such as date added, release date, play count, or duration) is displayed on tiles, with options dynamically filtered based on the content type (e.g., tracks vs. albums).

lib/components/LayoutSettingsScreen/CustomizationSettingsScreen · high confidence

New settings screens and UI components for downloads, customization, and accessibility

This change introduces a suite of new screens and components within the \lib/screens\ directory to enhance user configuration and management. Users can now access dedicated settings for accessibility (high contrast, gesture/vibration toggles), audio service behavior (buffer size, fade-in/out, Android-specific offloading/ducking), and content customization (media notification buttons, marquee text, release date display). The downloads experience is expanded with new screens for managing download locations (including Android-specific app directory support), viewing active downloads and errors, and configuring download settings. Additionally, layout and content view type settings allow per-tab grid/list customization, while artist and album screens now feature specific settings for section ordering and cover visibility.

lib/screens · high confidence

Redesigned home screen with quick actions and section presets

The home screen has been restructured to feature a row of customizable quick-action buttons at the top, allowing users to pin frequent tasks like playing specific items or random favorites. Below these actions, the main content area now uses a new provider-based system to display home sections, which can be configured as tabs, collections, or queues. Users can now edit these sections and quick actions directly via new bottom-sheet menus, and the layout adapts to different screen sizes with improved padding and alignment for both mobile and desktop views.

lib/components/HomeScreen · high confidence

iOS native configuration for CarPlay, Siri, and deep linking

The iOS app now supports CarPlay and Siri voice commands, allowing users to play music via voice or the CarPlay interface. This change adds the necessary native iOS configuration, including scene delegates for CarPlay integration, Siri intent handling, and deep link support. It also introduces a native splash screen with light and dark mode backgrounds and configures the app to exclude downloaded songs from iCloud backups.

ios/Runner · high confidence

Removals

Removed web entry point and PWA manifest

The web entry point (index.html) and the Progressive Web App manifest (manifest.json) have been removed from the web directory. This eliminates the ability to run the application as a standalone PWA in browsers and removes the associated service worker registration and icon configurations.

web · high confidence

Behavioural changes

4 commits (0 fixes) modifying windows/runner/resources

A change to existing behaviour in windows/runner/resources — 4 commits, 3 files: “move to narrower code signing certificate for Windows builds”; “enable building MSIX app bundles for windows”; “(mostly) working windows version”; and 1 more.

windows/runner/resources · medium confidence · unverified

6 commits (0 fixes) modifying windows/runner

A change to existing behaviour in windows/runner — 6 commits, 11 files: “match existing Finamp windows by substring instead of full string”; “(mostly) working windows version”; “add custom url scheme handling for all platforms except iOS”; and 3 more.

windows/runner · medium confidence · unverified

Android app modernization and native feature integration

The Android application has been significantly updated to support modern Android features and improve stability. The package name has changed to com.unicornsonlsd.finamp, and the app now uses a Kotlin-based MainActivity that integrates with the audio\_service plugin for background playback. New capabilities include handling Android Auto intents (MUSIC\_PLAYER), supporting user-installed SSL certificates via a MethodChannel, and providing a native output switcher dialog. The UI has been enhanced with a native splash screen that respects light/dark modes, a black navigation bar, and a monochrome adaptive icon. Additionally, the app now includes proper locale configuration for language support, data extraction rules for backups, and a MediaItemContentProvider to resolve artwork for Android Auto.

android/app · high confidence

Improved locale handling and platform-aware keyboard shortcuts

The application now ensures date formatting falls back to English (en\_US) when the user's locale lacks necessary data, preventing display errors. Additionally, keyboard shortcut hints and UI labels are now platform-specific, using Mac-style symbols (⌘, ⇧, ⌥) on iOS and macOS, and standard symbols on other platforms, with these hints restricted to desktop environments.

lib/utils · high confidence

Improved queue restore tiles with metadata and context menus

The queue restore screen now displays richer information for each saved queue, including the album cover of the current track, the queue creation date, and a breakdown of total versus remaining tracks. Tapping or long-pressing a tile opens a context menu for further actions, and the restore button now archives the current saved queue before loading the selected one, ensuring a cleaner state transition.

lib/components/QueueRestoreScreen · high confidence

Language selection screen now displays all supported locales with native names

The language selection interface has been refactored to present a complete list of all supported application locales. Users can now see every available language option, with each entry displaying the language name in its native script (e.g., 'Deutsch' instead of 'German') and including country-specific details where applicable. A new 'System' option allows users to revert to the device's default locale, and the list is sorted alphabetically by language tag for easier navigation.

lib/components/LanguageSelectionScreen · high confidence

Migrate persistent storage to Isar and Hive CE

The application's data persistence layer has been migrated from the legacy Hive implementation to Isar for structured data (such as the user profile, settings, and queue state) and Hive CE for specific type adapters. This change introduces new model classes like \FinampUser\ and \FinampSettings\ with dedicated adapters, alongside a migration adapter (\FinampStorableQueueInfoMigrationAdapter\) to handle the transition of existing queue data. Users will benefit from improved performance and reliability in saving and restoring playback queues, settings, and user preferences across app restarts.

lib/models · high confidence

New Add-to-Playlist screen with configurable tap behavior and offline support

The app now uses a dedicated AddToPlaylistScreen (comprising AddToPlaylistButton, AddToPlaylistList, and NewPlaylistDialog) for adding tracks to playlists. The button respects the new setting preferAddingToFavoritesOverPlaylists: a tap toggles favorites when this is true, otherwise it opens the playlist actions menu; a long-press does the opposite. The playlist list shows existing playlists with loading states and a button to create a new playlist, which fetches children for albums/playlists to preserve order. Offline mode is handled by showing a snackbar message when attempting to open the playlist menu while offline.

lib/components/AddToPlaylistScreen · high confidence

New Playback Action Row with swipeable pages and persistent page selection

The playback menu now uses a new \PlaybackActionRow\ component that organizes actions into swipeable pages (e.g., New Queue, Play Next, Append to Next Up, Append to Queue) with a page indicator. This row supports a compact layout mode and remembers the last used page per context (regular vs. queue menu) via a new setting, so your preferred action tab is restored on subsequent opens. The row also adapts available actions based on item type (tracks vs. albums/artists/genres) and queue state, including new shuffle options for albums and genre-specific labels.

lib/menus/components/playbackActions · high confidence

New audio service settings controls and UI refinements

The Audio Service Settings screen now includes dedicated controls for configuring the audio buffer duration, enabling the automatic loading of the last queue on startup, and managing the Android foreground service behavior on pause. Additionally, shuffle behavior settings have been updated to use the term 'track' instead of 'song', and the interface has been improved with adaptive switch tiles and localized text for better consistency and usability.

lib/components/AudioServiceSettingsScreen · high confidence

New multi-step login flow with server discovery and quick connect

The login experience has been replaced with a structured, multi-step wizard (Splash → Server Selection → User Selection → Authentication) that improves clarity and usability. On the Server Selection page, the app now actively scans the local network for Jellyfin servers and displays them for selection, while also guiding users to manual entry if no servers are found after a brief wait. The User Selection page supports Quick Connect for faster authentication and allows users to choose from discovered accounts. The Authentication page provides a dedicated form for username and password entry. Additionally, the flow now handles mTLS requirements by prompting users to install client certificates when a discovered server requires them, and it updates client capabilities for remote control upon successful login.

lib/components/LoginScreen · high confidence

New startup sequence and logging infrastructure

The application now initializes a dedicated logging system via \setup\_logging.dart\ that captures logs to a file and applies a \verboseLogging\ toggle to cap output in release builds, improving diagnostic capabilities without impacting performance. The startup sequence in \main.dart\ has been restructured to explicitly handle edge-to-edge overlay styles, Hive/Isar database setup, and a series of data migrations (including theme mode, locale, and download locations) before launching the UI. Additionally, a new generated color scheme file (\color\_schemes.g.dart\) introduces an AMOLED dark theme option and dynamic color support, replacing the previous hardcoded color definitions.

lib · high confidence

New utility extensions for color contrast, theming, and string handling

This change introduces a new set of Dart extensions in the \lib/extensions\ directory to improve UI consistency and code safety. The \color\_extensions.dart\ file adds logic to automatically calculate and apply text colors that meet contrast requirements against any background, and provides a \withColorScheme\ method for \ThemeData\ that ensures text themes are correctly updated when color schemes change. Additionally, new extensions include safe list slicing (\list.dart\), localized string access via \BuildContext\ (\localizations.dart\), robust null/blank string checks (\string.dart\), and hex color string parsing (\string.dart\).

lib/extensions · high confidence

Redesigned Artist Screen with Genre Filtering and Offline Support

The Artist Screen has been rebuilt to support genre-based filtering, allowing users to view an artist's tracks and albums filtered by specific genres via dedicated chips. The new layout includes a flexible space bar with an album image, track/album counts, and a playback action row, while the main content area displays curated sections (such as Top Tracks, Albums, and Appears On) that are now offline-capable with local sorting and filtering. This change introduces a new 'See All' navigation path for full track lists and integrates with the global sort-and-filter configuration system.

lib/components/ArtistScreen · high confidence

Redesigned Music Screen with new list/grid components and sort/filter controls

The Music Screen has been rebuilt with a new set of UI components, including dedicated widgets for artist lists, item cards, and collection list tiles, alongside a new tab view implementation. This change introduces a unified Sort and Filter row that allows users to manage sorting and filtering directly within the screen, including genre filtering and offline mode overrides. The update also adds an alphabetical jump-to-letter navigation bar for faster browsing and an automatic offline mode status indicator to show when manual overrides are active.

lib/components/MusicScreen · high confidence

Redesigned UI components and visual enhancements

This update introduces a comprehensive redesign of the application's visual interface. Key changes include a new \AlbumImage\ component that supports tap-to-zoom, blurhash placeholders, and consistent theming, as well as a redesigned \NowPlayingBar\ with improved contrast and animations. The interface now features a \GlobalSnackbar\ system for better error and message management, a \FavoriteButton\ for quick item favoriting, and new \CuratedItemSections\ with filter rows for tracks. Additionally, audio fade-in/fade-out visualizers, artist text spans with offline support, and a new \FinampSectionHeader\ with swipe actions have been added to enhance usability and aesthetics.

lib/components · high confidence

Redesigned album and playlist screens with unified download and playback controls

The album and playlist views have been rebuilt to provide a cohesive experience for browsing and managing music. The new layout features a flexible space bar that displays the album art, artist information, and a dedicated playback action row for immediate controls. A prominent download button is now integrated into the header, offering clear status indicators and options to manage offline content, including a new dialog for configuring transcoding and download locations. Track lists have been redesigned to show detailed metadata, support multi-disc grouping, and include swipe actions for quick management, while playlist-specific features like editing and genre filtering are now seamlessly accessible within the screen.

lib/components/AlbumScreen · high confidence

Redesigned download error list with localized headers and artist subtitles

The DownloadsErrorScreen now displays a structured list of failed or syncing downloads using a sticky header that shows a localized title (e.g., "Active Downloads") and color-codes the header based on the error state (failed/syncFailed vs. others). Each item in the list shows the album art, the item name, and a subtitle that either displays the item type (for sync failures) or the processed artist name, improving clarity and localization for users troubleshooting download issues.

lib/components/DownloadsErrorScreen · high confidence

Redesigned downloads screen with grouped items and repair tools

The downloads screen has been redesigned to group downloaded items by type (such as tracks, albums, and artists) using expansion tiles, providing a clearer overview of your library. A new overview card displays real-time counts for total, complete, failed, and active downloads, while a dedicated repair button allows you to fix missing or corrupted files. The interface now also shows detailed metadata for each item, including file size, codec, bitrate, and download location, and includes a warning if blurhash images are missing.

lib/components/DownloadsScreen · high confidence

Redesigned player screen with new album/artist chips and control area

The player screen has been redesigned to improve layout and usability. The album and artist information is now displayed using dedicated, themed chips (AlbumChip, ArtistChip) that support optional release dates and artist images, and are tappable to navigate to the respective detail screens. Playback controls have been reorganized into a new ControlArea widget, which groups the feature chips (displaying metadata like codec, bitrate, and volume), the progress slider, and the main player buttons (play/pause, skip, loop/shuffle). The album artwork area now supports direct tap-to-play/pause, double-tap-to-like, and horizontal swipe-to-skip gestures.

lib/components/PlayerScreen · high confidence

Refactored transcoding settings UI into modular components

The TranscodingSettingsScreen now uses dedicated, localized widgets for its controls. A new TranscodeSwitch component provides an adaptive toggle to enable or disable transcoding, while a new BitrateSelector component offers a slider to adjust the transcode bitrate (64–320 kbps), which is automatically disabled when the FLAC codec is selected. Both components are fully integrated with the app's localization system for user-facing text.

lib/components/TranscodingSettingsScreen · high confidence

Safer download location deletion with default location management

The Download Location Settings screen now prevents users from deleting a location that contains active downloads, displaying a dialog with the affected items instead. Additionally, users can now designate a specific download location as the default using a star icon in the list, and the delete action is only available for locations that do not require a persistent path.

lib/components/DownloadLocationSettingsScreen · high confidence

Standardized menu entry components and expanded context menu actions

The menu system has been refactored to use a unified \MenuEntry\ widget, ensuring consistent styling and behavior across all items. This change introduces several new capabilities: users can now create playlists directly from the current queue, add items to existing playlists, and manage instant mixes by adding or removing artists, albums, and genres. Download management is more granular with dedicated entries for locking incidental downloads, deleting from device, and an adaptive entry that intelligently shows the most relevant download action. Navigation is improved with direct links to album, artist, and genre screens from item menus, and queue management now includes options to remove items, restore a previous queue, or stop and clear the queue. Additional utility entries allow users to edit home screen sections, toggle favorites, view logs, and dismiss all snackbars.

lib/menus/components/menuEntries · high confidence

Updated Xcode scheme configuration for Flutter debugging and GPU validation

The iOS build scheme has been updated to Xcode version 15.10, which includes the addition of a custom LLDB initialization file for Flutter debugging and the enabling of GPU validation mode during launch. Additionally, empty test and additional options sections have been reorganized within the scheme configuration.

ios/Runner.xcodeproj/xcshareddata · high confidence

Updated iOS workspace file reference

The iOS workspace configuration now references the project using a self-referencing path instead of a group-based path, ensuring the workspace correctly points to the project file location.

ios/Runner.xcodeproj/project.xcworkspace · high confidence

iOS deployment target raised to 15.0 and CocoaPods integration enabled

The app now requires iOS 15.0 or later, updating the minimum OS version from 8.0. Additionally, the build configuration has been updated to include CocoaPods support by referencing the Pods xcconfig files and adding the Pods project to the workspace, ensuring dependencies are correctly linked during the build process.

ios/Flutter · high confidence

iOS project modernized with scene-based lifecycle and split Info.plist configurations

The iOS build configuration has been updated to support modern iOS app lifecycle management by introducing a SceneDelegate and replacing the single Info.plist with separate Info-Debug, Info-Profile, and Info-Release plist files. This change also adds required entitlements, integrates the Pods framework and libsqlite3 dependency, and registers a wide range of new localization strings (including Finnish, Hindi, Persian, Serbian, and others) to ensure the app correctly displays translated text across different regions.

ios/Runner.xcodeproj · high confidence

Test coverage

15 commits adding/updating tests in test; Added integration tests for app startup, login, and playback.

Dependencies

Major dependency and build system overhaul

The project has been upgraded to Flutter 3.9+ and Dart 3.9+, requiring a significant migration of the build infrastructure. Android build scripts now use the new Gradle plugin management DSL, Kotlin 2.3.21, and Java 17, while the Android package name has been updated to com.unicornsonlsd.finamp. iOS and macOS platforms now enforce deployment targets of iOS 15.0 and macOS 10.15 respectively, with updated CocoaPods configurations. Core dependencies have been updated or replaced, including switching to a custom fork of just\_audio for queue shuffle support, updating audio\_service to 0.18.18, and migrating to hive\_ce for local storage.

(dependencies) · high confidence

Upgrade Gradle wrapper to version 8.14.4

The Android build system has been upgraded from Gradle 5.6.2 to 8.14.4. This update includes new configuration properties for network timeout and distribution URL validation, which may affect build performance and reliability during dependency resolution.

android/gradle · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 47 → 45 (-2.1)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

Lenses

  • Code Health 72 → 72 (+0.0)
  • Architecture 81 → 81 (+0.0)
  • Maturity 65 → 65 (+0.3)
  • Readiness 43 → 40 (-3.1)
  • Security 38 → 35 (-3.0)
  • Domain Modelling 88 → 88 (+0.0)
  • Performance 60 → 60 (+0.0)

Resolved (34)

  • Change coupling: login_server_selection_page.dart ↔ login_user_selection_page.dart (lib/components/LoginScreen/login_server_selection_page.dart)
  • DataSourceService._onDataSourceChange (cognitive 28) (lib/services/data_source_service.dart)
  • DataSourceService._onDataSourceChange (cyclomatic 16) (lib/services/data_source_service.dart)
  • Duplicated block (10 lines × 3) (lib/components/AudioServiceSettingsScreen/buffer_duration_list_tile.dart)
  • Duplicated block (10 lines × 6) (lib/menus/components/menu_item_info_header.dart)
  • Duplicated block (11 lines × 2) (lib/components/AlbumScreen/track_list_tile.dart)
  • Duplicated block (11 lines × 2) (lib/menus/components/menu_item_info_header.dart)
  • Duplicated block (12 lines × 2) (ios/Runner/AppDelegate.swift)
  • Duplicated block (12 lines × 2) (lib/components/MusicScreen/sort_and_filter_row.dart)
  • Duplicated block (12 lines × 5) (lib/menus/components/menu_item_info_header.dart)
  • Duplicated block (13–14 lines × 2) (lib/services/jellyfin_api_helper.dart)
  • Duplicated block (20–21 lines × 2) (lib/services/jellyfin_api_helper.dart)
  • Duplicated block (26–27 lines × 2) (lib/services/android_auto_helper.dart)
  • Duplicated block (5 lines × 2) (lib/components/AlbumScreen/track_list_tile.dart)
  • Duplicated block (5 lines × 2) (lib/services/android_auto_helper.dart)
  • Duplicated block (7 lines × 2) (lib/components/SettingsScreen/logout_list_tile.dart)
  • Duplicated block (8 lines × 2) (lib/components/SettingsScreen/finamp_settings_dropdown.dart)
  • Duplicated block (8 lines × 7) (lib/components/AudioServiceSettingsScreen/buffer_duration_list_tile.dart)
  • Duplicated block (9 lines × 2) (lib/components/MusicScreen/sort_and_filter_row.dart)
  • High: security finding (details withheld)
  • …and 14 more

New (57)

  • Change coupling: artist_item_info.dart ↔ artist_screen_content.dart (lib/components/ArtistScreen/artist_item_info.dart)
  • Duplicated block (10 lines × 3) (lib/components/AudioServiceSettingsScreen/buffer_duration_list_tile.dart)
  • Duplicated block (10 lines × 6) (lib/menus/components/menu_item_info_header.dart)
  • Duplicated block (10–11 lines × 2) (lib/services/music_player_background_task.dart)
  • Duplicated block (11 lines × 2) (lib/components/AlbumScreen/track_list_tile.dart)
  • Duplicated block (11 lines × 2) (lib/menus/components/menu_item_info_header.dart)
  • Duplicated block (12 lines × 2) (ios/Runner/AppDelegate.swift)
  • Duplicated block (12 lines × 5) (lib/menus/components/menu_item_info_header.dart)
  • Duplicated block (13 lines × 2) (lib/components/AlbumScreen/track_list_tile.dart)
  • Duplicated block (13–14 lines × 2) (lib/services/jellyfin_api_helper.dart)
  • Duplicated block (16–17 lines × 2) (lib/services/android_auto_helper.dart)
  • Duplicated block (20–21 lines × 2) (lib/services/jellyfin_api_helper.dart)
  • Duplicated block (5 lines × 2) (lib/components/AlbumScreen/track_list_tile.dart)
  • Duplicated block (7 lines × 2) (lib/services/android_auto_helper.dart)
  • Duplicated block (8 lines × 7) (lib/components/AudioServiceSettingsScreen/buffer_duration_list_tile.dart)
  • Edited copies of one member (3 members, 10+ corresponding lines) (lib/screens/interaction_settings_screen.dart)
  • Edited copies of one member (3 members, 12+ corresponding lines) (lib/services/music_player_background_task.dart)
  • Edited copies of one member (3 members, 13+ corresponding lines) (lib/screens/accessibility_settings_screen.dart)
  • Edited copies of one member (3 members, 34+ corresponding lines) (lib/services/queue_service.dart)
  • Edited copies of one member (3 members, 69+ corresponding lines) (lib/components/PlayerScreen/queue_list.dart)
  • …and 37 more

Changes since last survey

  • 60 commits — 33 feature/other, 27 fixes

By area

  • (repo) — 18 commits
  • lib/services — 9 commits
  • lib/components — 7 commits
  • lib/l10n — 7 commits
  • (root) — 6 commits
  • assets/com.unicornsonlsd.finamp.metainfo.xml — 4 commits
  • fastlane/metadata — 4 commits
  • contribution-evidence/2026-10-30-player-actions — 2 commits
  • android/app — 1 commit
  • integration_test/test_cases.dart — 1 commit
  • lib/menus — 1 commit

Notable commits

  • fix: Attempt to fix main() hanging in Linux CI.
  • fix: Fix linux CI failing due to missing dbus service.
  • fix: Merge branch 'hotfix-1.0.2' of https://github.com/finamp-app/finamp into redesign
  • fix: Merge pull request #1821 from maredan/fix/network-handoffs
  • fix: Merge pull request #1830 from pengusto/fix/home-section-title-validation
  • fix: Merge pull request #1832 from pengusto/fix/artist-screen-track-loading
  • fix: Merge pull request #1834 from pengusto/fix/offline-performing-artist-filter
  • fix: Merge pull request #1836 from pengusto/fix/player-output-menu
  • fix: Merge pull request #1843 from maredan/fix/skip-empty-offline-queue
  • fix: Merge pull request #1866 from maredan/fix/home-section-offline-transition
  • fix: fix br instead of b for emphasis
  • fix: fix error in polish translation syntax
  • fix: fix old feature panels on F-Droid
  • fix: fix: address network handoff review feedback
  • fix: fix: address offline queue reload review
  • fix: fix: align generated settings helper
  • fix: fix: avoid offline mode before public fallback
  • fix: fix: clarify offline queue reload prompt
  • fix: fix: filter offline performing tracks by the selected artist
  • fix: fix: handle stale offline home sections during reconnect
  • …and 40 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

finamp-app/finamp was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 12 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit e94a458bbe0668af4fbe4a576cf1206e0233362f — the exact code this score is about.
  • Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.42+preprod-6bc2a431cb25.