Added checkbox color customization and updated to v10.1.3

Author: TutorialsAndroid

Readme.md

@@ -49,7 +49,7 @@ If this library helps you, please consider supporting my open-source work.
 ## Table of Contents
 
 - [Overview](#overview)
-- [What is new in v10.1.2](#what-is-new-in-v1012)
+- [What is new in v10](#what-is-new-in-v10)
 - [Important Android storage reality](#important-android-storage-reality)
 - [Requirements](#requirements)
 - [Installation](#installation)
@@ -71,7 +71,7 @@ If this library helps you, please consider supporting my open-source work.
 - [Handling Android 14+ partial photo/video access](#handling-android-14-partial-photovideo-access)
 - [Play Store safe integration options](#play-store-safe-integration-options)
 - [Troubleshooting](#troubleshooting)
-- [Migration guide from v9.x to v10.1.2](#migration-guide-from-v9x-to-v1012)
+- [Migration guide from v9.x to v10.1.3](#migration-guide-from-v9x-to-v1013)
 - [Security and privacy recommendations](#security-and-privacy-recommendations)
 - [FAQ](#faq)
 - [Contributing](#contributing)
@@ -105,9 +105,13 @@ dialog.setDialogSelectionListener(files -> {
 
 ---
 
-## What is new in v10.1.2
+## What is new in v10
 
-Version `10.1.2` focuses on modern Android support, stability, clearer storage behavior, dialog customization, and advanced file filtering.
+Version `10.X.X` focuses on modern Android support, stability, clearer storage behavior, dialog customization, and advanced file filtering.
+
+### New in v10.1.3
+
+- From `v10.1.3`, FilePicker supports checkbox color customization through `DialogProperties`.
 
 ### New in v10.1.2
 
@@ -198,7 +202,7 @@ Official references:
 
 ## Installation
 
-FilePicker v10.1.1 is available through **Maven Central** and **JitPack**.
+FilePicker v10.1.3 is available through **Maven Central** and **JitPack**.
 
 Recommended installation method: **Maven Central**  
 Alternative installation method: **JitPack**
@@ -313,15 +317,15 @@ Add the FilePicker dependency inside the `dependencies` block.
 
 ```gradle
 dependencies {
-    implementation "io.github.tutorialsandroid:filepicker:10.1.2"
+    implementation "io.github.tutorialsandroid:filepicker:10.1.3"
 }
 ```
 
 ### Kotlin DSL - app/build.gradle.kts
 
 ```kotlin
 dependencies {
-    implementation("io.github.tutorialsandroid:filepicker:10.1.2")
+    implementation("io.github.tutorialsandroid:filepicker:10.1.3")
 }
 ```
 
@@ -479,15 +483,15 @@ Add the dependency inside the `dependencies` block.
 
 ```gradle
 dependencies {
-    implementation "com.github.TutorialsAndroid:FilePicker:v10.1.2"
+    implementation "com.github.TutorialsAndroid:FilePicker:v10.1.3"
 }
 ```
 
 ### Kotlin DSL - app/build.gradle.kts
 
 ```kotlin
 dependencies {
-    implementation("com.github.TutorialsAndroid:FilePicker:v10.1.2")
+    implementation("com.github.TutorialsAndroid:FilePicker:v10.1.3")
 }
 ```
 
@@ -526,13 +530,13 @@ android {
 For production apps, Maven Central is recommended:
 
 ```gradle
-implementation "io.github.tutorialsandroid:filepicker:10.1.2"
+implementation "io.github.tutorialsandroid:filepicker:10.1.3"
 ```
 
 Use JitPack only if you specifically want to fetch the library directly from GitHub:
 
 ```gradle
-implementation "com.github.TutorialsAndroid:FilePicker:v10.1.2"
+implementation "com.github.TutorialsAndroid:FilePicker:v10.1.3"
 ```
 
 ---
@@ -578,15 +582,15 @@ Only use the old `allprojects` method if your project is very old and does not h
 
 ```gradle
 dependencies {
-    implementation "io.github.tutorialsandroid:filepicker:10.1.2"
+    implementation "io.github.tutorialsandroid:filepicker:10.1.3"
 }
 ```
 
 ### JitPack
 
 ```gradle
 dependencies {
-    implementation "com.github.TutorialsAndroid:FilePicker:v10.1.2"
+    implementation "com.github.TutorialsAndroid:FilePicker:v10.1.3"
 }
 ```
 
@@ -924,6 +928,46 @@ FilePickerDialog dialog = new FilePickerDialog(
 
 ---
 
+## Customizing checkbox colors
+
+From `v10.1.3`, FilePicker supports checkbox color customization through `DialogProperties`.
+
+This is useful when the default checkbox colors do not match your app theme, or when the unchecked checkbox blends into a white/light background.
+
+```java
+import android.graphics.Color;
+
+DialogProperties properties = new DialogProperties();
+
+properties.selection_mode = DialogConfigs.MULTI_MODE;
+properties.selection_type = DialogConfigs.DIR_SELECT;
+
+// Checked checkbox fill color
+properties.checkbox_checked_color = Color.parseColor("#6750A4");
+
+// Unchecked checkbox outer/background color
+properties.checkbox_unchecked_color = Color.parseColor("#6750A4");
+
+// Tick/checkmark color shown when checked
+properties.checkbox_checkmark_color = Color.WHITE;
+
+// Inner color shown when unchecked
+properties.checkbox_unchecked_inner_color = Color.parseColor("#F3E8FF");
+
+FilePickerDialog dialog = new FilePickerDialog(MainActivity.this, properties);
+dialog.setTitle("Select Directory");
+dialog.show();
+```
+
+### Notes
+
+- `checkbox_checked_color` controls the selected checkbox fill color.
+- `checkbox_unchecked_color` controls the unchecked checkbox outer/background color.
+- `checkbox_checkmark_color` controls the tick/checkmark color.
+- `checkbox_unchecked_inner_color` controls the inner unchecked color.
+- If `checkbox_checked_color` is not set, FilePicker uses the existing `R.color.colorAccent` fallback.
+- This works for file selection, directory selection, and file + directory selection.
+
 ## Changing dialog width and height
 
 This section answers a common GitHub issue/question: **"Change Width and Height"**.
@@ -1908,7 +1952,7 @@ Possible causes:
 
 ---
 
-## Migration guide from v9.x to v10.1.2
+## Migration guide from v9.x to v10.1.3
 
 ### 1. Update dependency
 
@@ -1965,7 +2009,7 @@ Only use `MANAGE_EXTERNAL_STORAGE` when the answer is policy-safe.
 
 ### 5. Update dialog size usage if needed
 
-If your old app looked too narrow on landscape, tablet, foldable, or ultra-wide screens, use the v10.1.2 sizing API:
+If your old app looked too narrow on landscape, tablet, foldable, or ultra-wide screens, use the v10.1.3 sizing API:
 
 ```java
 dialog.setDialogSizeByPercent(0.85f, 0.75f);

library/build.gradle

@@ -4,7 +4,7 @@ group='com.github.TutorialsAndroid'
 
 ext {
     PUBLISH_GROUP_ID = 'io.github.tutorialsandroid'
-    PUBLISH_VERSION = '10.1.2'
+    PUBLISH_VERSION = '10.1.3'
     PUBLISH_ARTIFACT_ID = 'filepicker'
     PUBLISH_DESCRIPTION = 'Android Library to select files/directories from Device Storage'
     PUBLISH_URL = 'https://github.com/TutorialsAndroid/FilePicker'

library/src/main/java/com/developer/filepicker/controller/adapters/FileListAdapter.java

@@ -72,6 +72,12 @@ public View getView(final int position, View convertView, ViewGroup parent) {
         applySelectionAnimation(convertView, item);
         bindIcon(holder, item);
         bindTexts(holder, item, isParentRow);
+        holder.checkbox.setCheckboxColors(
+                properties.checkbox_checked_color,
+                properties.checkbox_unchecked_color,
+                properties.checkbox_checkmark_color,
+                properties.checkbox_unchecked_inner_color
+        );
 
         holder.checkbox.setOnCheckedChangedListener(null);
         holder.checkbox.setVisibility(isSelectable ? View.VISIBLE : View.INVISIBLE);

library/src/main/java/com/developer/filepicker/model/DialogProperties.java

@@ -1,5 +1,7 @@
 package com.developer.filepicker.model;
 
+import android.graphics.Color;
+
 import java.io.File;
 
 /**
@@ -9,6 +11,11 @@
  */
 public class DialogProperties {
 
+    /**
+     * Internal sentinel used when a color should fall back to the library default.
+     */
+    public static final int COLOR_NOT_SET = Integer.MIN_VALUE;
+
     public int selection_mode;
     public int selection_type;
     public File root;
@@ -43,6 +50,30 @@ public class DialogProperties {
      */
     public long min_file_size = -1L;
 
+    /**
+     * Checked checkbox fill color.
+     *
+     * Default COLOR_NOT_SET means the picker will use R.color.colorAccent.
+     */
+    public int checkbox_checked_color = COLOR_NOT_SET;
+
+    /**
+     * Unchecked checkbox outer/background color.
+     */
+    public int checkbox_unchecked_color = Color.parseColor("#C1C1C1");
+
+    /**
+     * Checked checkbox tick/checkmark color.
+     */
+    public int checkbox_checkmark_color = Color.WHITE;
+
+    /**
+     * Unchecked checkbox inner fill color.
+     *
+     * Change this if the unchecked checkbox blends into a white/light background.
+     */
+    public int checkbox_unchecked_inner_color = Color.WHITE;
+
     public DialogProperties() {
         selection_mode = DialogConfigs.SINGLE_MODE;
         selection_type = DialogConfigs.FILE_SELECT;
@@ -55,5 +86,11 @@ public DialogProperties() {
         // v10.1.2 file size filters
         max_file_size = -1L;
         min_file_size = -1L;
+
+        // v10.1.3 checkbox color customization
+        checkbox_checked_color = COLOR_NOT_SET;
+        checkbox_unchecked_color = Color.parseColor("#C1C1C1");
+        checkbox_checkmark_color = Color.WHITE;
+        checkbox_unchecked_inner_color = Color.WHITE;
     }
 }

library/src/main/java/com/developer/filepicker/widget/MaterialCheckbox.java

@@ -11,6 +11,7 @@
 import android.view.View;
 
 import com.developer.filepicker.R;
+import com.developer.filepicker.model.DialogProperties;
 
 /**
  * Lightweight custom checkbox used by the file picker rows.
@@ -24,6 +25,11 @@ public class MaterialCheckbox extends View {
     private boolean checked;
     private OnCheckedChangeListener onCheckedChangeListener;
 
+    private int checkedColor = DialogProperties.COLOR_NOT_SET;
+    private int uncheckedColor = Color.parseColor("#C1C1C1");
+    private int checkmarkColor = Color.WHITE;
+    private int uncheckedInnerColor = Color.WHITE;
+
     public MaterialCheckbox(Context context) {
         super(context);
         initView();
@@ -67,22 +73,22 @@ protected void onDraw(Canvas canvas) {
 
         if (checked) {
             paint.setStyle(Paint.Style.FILL);
-            paint.setColor(getColorCompat(R.color.colorAccent));
+            paint.setColor(resolveCheckedColor());
             canvas.drawRoundRect(bounds, minDim / 8f, minDim / 8f, paint);
 
-            paint.setColor(Color.WHITE);
+            paint.setColor(checkmarkColor);
             paint.setStrokeWidth(Math.max(2f, minDim / 10f));
             paint.setStyle(Paint.Style.STROKE);
             paint.setStrokeCap(Paint.Cap.ROUND);
             paint.setStrokeJoin(Paint.Join.ROUND);
             canvas.drawPath(tick, paint);
         } else {
             paint.setStyle(Paint.Style.FILL);
-            paint.setColor(Color.parseColor("#C1C1C1"));
+            paint.setColor(uncheckedColor);
             canvas.drawRoundRect(bounds, minDim / 8f, minDim / 8f, paint);
 
             bounds.set(minDim / 5f, minDim / 5f, minDim - (minDim / 5f), minDim - (minDim / 5f));
-            paint.setColor(Color.WHITE);
+            paint.setColor(uncheckedInnerColor);
             canvas.drawRect(bounds, paint);
         }
     }
@@ -121,6 +127,27 @@ public void setOnCheckedChangedListener(OnCheckedChangeListener onCheckedChangeL
         this.onCheckedChangeListener = onCheckedChangeListener;
     }
 
+    /**
+     * Applies checkbox colors from DialogProperties.
+     */
+    public void setCheckboxColors(int checkedColor,
+                                  int uncheckedColor,
+                                  int checkmarkColor,
+                                  int uncheckedInnerColor) {
+        this.checkedColor = checkedColor;
+        this.uncheckedColor = uncheckedColor;
+        this.checkmarkColor = checkmarkColor;
+        this.uncheckedInnerColor = uncheckedInnerColor;
+        invalidate();
+    }
+
+    private int resolveCheckedColor() {
+        if (checkedColor == DialogProperties.COLOR_NOT_SET) {
+            return getColorCompat(R.color.colorAccent);
+        }
+        return checkedColor;
+    }
+
     private int getColorCompat(int colorRes) {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
             return getResources().getColor(colorRes, getContext().getTheme());

sample/build.gradle

@@ -8,8 +8,8 @@ android {
         applicationId "com.developer.filepicker.file"
         minSdkVersion 23
         targetSdkVersion 37
-        versionCode 17
-        versionName "10.1.2"
+        versionCode 18
+        versionName "10.1.3"
     }
     buildTypes {
         release {

sample/src/main/java/com/developer/filepicker/file/MainActivity.java

@@ -5,6 +5,7 @@
 import android.Manifest;
 import android.content.Intent;
 import android.content.pm.PackageManager;
+import android.graphics.Color;
 import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;