https://github.com/charlesmuchene/pref-editor-desktop

Desktop tool to View and Edit shared + datastore preferences.
https://github.com/charlesmuchene/pref-editor-desktop

datastore-android datastore-preferences shared-preferences-android

Last synced: 7 days ago
JSON representation

Desktop tool to View and Edit shared + datastore preferences.

• Host: GitHub
• URL: https://github.com/charlesmuchene/pref-editor-desktop
• Owner: charlesmuchene
• License: apache-2.0
• Created: 2024-01-18T04:55:24.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-07-09T05:02:02.000Z (6 months ago)
• Last Synced: 2024-11-12T09:17:22.585Z (2 months ago)
• Topics: datastore-android, datastore-preferences, shared-preferences-android
• Language: Kotlin
• Homepage:
• Size: 8.92 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Preferences Editor

A desktop app to view and edit on-device preferences. The app supports reading/writing _legacy_ **shared preferences**.

**Datastore-based** preferences are currently supported in read-only mode. 😎

Built using:

* [Compose](https://github.com/JetBrains/compose-multiplatform) for Desktop

* Themed by [Jewel](https://github.com/JetBrains/jewel)

# Installation

> Ensure `adb` is available on your `PATH`.

Find and install the [latest release](https://github.com/charlesmuchene/pref-editor-desktop/releases/latest).

The app can be run from source too. See the section on [Building](#building) below.

# Usage

>  [!IMPORTANT]  

>  A local installation of ADB is required. It should be included in the Android SDK Platform Tools package downloaded while setting up Android Studio.

If not, download the package with the SDK Manager or get the standalone tools from [here](https://developer.android.com/studio/releases/platform-tools).

From the app's window:

* Select device

* Choose your app

* Select preferences file

* View/Edit preferences

* Star any item for easier filtering

| Device Listing                                | Editing Preferences                        |

|-----------------------------------------------|--------------------------------------------|

| ![image](./images/01-pref-editor-devices.png) | ![image](./images/04-pref-editor-edit.png) |

And we go dark too 😎

| Preferences Files Listing                   | Filtering is supported                         |

|---------------------------------------------|------------------------------------------------|

| ![image](./images/03-pref-editor-files.png) | ![image](./images/02-pref-editor-filtered.png) |

# Building

[Clone](https://github.com/charlesmuchene/pref-editor-desktop/archive/refs/heads/main.zip) the project and execute `./gradlew run`. 

# License

    Copyright (c) 2024 Charles Muchene

    

    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

    

        http://www.apache.org/licenses/LICENSE-2.0

    

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.