repository·master·Indexed 23 days ago
https://github.com/zacharee/bifrostA cross-platform Samsung firmware downloader and decrypter ported from Samloader to Kotlin Multiplatform. Available for Windows, macOS, Linux, Android, and iOS, it features a GUI for downloading device firmware using Country Specific Code (CSC) selection. The documentation covers installation, building from source using Conveyor and Android Studio, CSC database querying via CSCDB, and internal API models like DownloadModel and DecryptModel.
To ensure the UI renders correctly on Linux, you must have at least one font family from each of the following categories installed:
Noto Sans or DejaVu SansNoto Serif, DejaVu Serif, or Times New RomanNoto Sans Mono or DejaVu Sans MonoComic Sans MS./gradlew :desktop:build (or .ash.bat :desktop:build on Windows) in the project root.conveyor command to package for your target:| Target | Command |
|---|---|
| Windows (x86) | conveyor -Kapp.machines=windows.amd64 make windows-zip |
| Windows (ARM64) | conveyor -Kapp.machines=windows.arm64 make windows-zip |
| Debian (x86) | conveyor -Kapp.machines=linux.amd64 make debian-package |
| Debian (ARM64) | conveyor -Kapp.machines=linux.arm64 make debian-package |
| Linux (x86) | conveyor -Kapp.machines=linux.amd64 make linux-tarball |
| Linux (ARM64) | conveyor -Kapp.machines=linux.arm64 make linux-tarball |
| Intel Mac | conveyor -Kapp.machines=mac.amd64 make unnotarized-mac-zip |
| Apple Silicon Mac | conveyor -Kapp.machines=mac.arm64 make unnotarized-mac-zip |
Binaries will be located in the output folder.
Via Command Line:
./gradlew :android:build(On Windows, use gradlew :android:build). The resulting APK will be in android/build/outputs/apk/debug.
Via Android Studio GUI:
android $\rightarrow$ Tasks $\rightarrow$ build.build.android/build/outputs/apk/debug.# Example: Building for Windows x86 via Conveyor
./gradlew :desktop:build
conveyor -Kapp.machines=windows.amd64 make windows-zipBifrost is a cross-platform Samsung firmware downloader available for Windows, macOS, Linux, Android, and iOS.
.zip matching your architecture (windows-amd64 for Intel/AMD or windows-aarch64 for ARM64) from bifrost.zwander.dev or the Releases page..zip matching your architecture (mac-amd64 for Intel or mac-aarch64 for Apple Silicon)..deb file for Debian-based systems or the .tar.gz file for other distributions. Choose the amd64 variant for Intel/AMD or arm64/aarch64 for ARM64.bifrost_android_<VERSION>.apk.The CSC (Country Specific Code) is required for downloading firmware. To find yours on a Samsung device:
The first three letters on the second line represent your current CSC. The last three letters represent the original/firmware CSC.
Example: XAA/XAA,XAA/XAU/TMB $\rightarrow$ Current CSC: XAA, Firmware CSC: TMB.
The application determines if transparency effects should be applied by combining the useMicaEffect and useVibrancyEffect settings. If either setting is true, useTransparencyEffects will emit true.
// Returns a Flow<Boolean> that is true if either Mica or Vibrancy is enabled
val useTransparencyEffects: Flow<Boolean>
get() = combine(Keys.useMicaEffect.asMutableStateFlow(), Keys.useVibrancyEffect.asMutableStateFlow()) { m, v -> m || v }asMutableStateFlow() method on a SettingsKey. This returns a MutableStateFlow that updates whenever the underlying setting changes and allows you to emit new values which are persisted to disk asynchronously on Dispatchers.IO.The FetchResult base class provides a utility method isReportableCode() to determine if a responseCode should be treated as an error that needs reporting.
By default, the following codes are considered ignoredCodes and will return false when calling isReportableCode():
408F01If the responseCode is not in this list, the method returns true.
BifrostSettings object provides access to the application's configuration keys. You can interact with these keys using the Keys nested object. Settings can be read or written using the invoke operator (e.g., Keys.someKey() to get the value, or Keys.someKey = newValue to set it).When working with CSCItem lists, you can use the SortBy sealed class hierarchy to define sorting logic. The SortBy classes provide a sortKey function used to determine the sort order.
Supported sorting types:
SortBy.Code(ascending: Boolean): Sorts by the CSC code.SortBy.Country(ascending: Boolean): Sorts by the resolved country name.SortBy.Carrier(ascending: Boolean): Sorts by the carrier name (if present).collectAsMutableState() extension method on a SettingsKey to create a MutableState that is automatically synchronized with the underlying settings. This handles lifecycle management: it registers a listener when the composable enters the composition and deactivates it when it leaves.The CSCDB object provides methods to search for Samsung Country Specific Code (CSC) items based on different criteria. It automatically initializes by loading a local CSV resource and attempting to fetch an updated list from a remote GitHub endpoint.
Available query methods:
getAll(): Returns all available CSCItem objects as a list.findForCountryQuery(query: String): Filters items where the country name (resolved from the country code) contains the query string (case-insensitive).findForCscQuery(query: String): Filters items where the CSC code contains the query string (case-insensitive).findForCarrierQuery(query: String): Filters items where any of the associated carrier names contain the query string (case-insensitive).findForGeneralQuery(query: String, items: Set<CSCItem> = this._items.value): A broad search that checks country names, CSC codes, and carrier names simultaneously.