izakirsheikh / toolz

Toolz is a Unit Converter app inspired from the archetecture of Windows 11 Calculator's Converter Section & built to Demonstrate use of Jetpack Compose with Modern Android Architecture Components & MVVM Architecture.

Toolz: ChatBot and Unit Converter

🌞 Preview

Shot-1	Shot-2	Shot-3	Shot-4	Shot-5	Shot-6	Shot-7

Features

Unit Converter

Toolz provides a comprehensive Unit Converter that simplifies complex unit conversions. You can effortlessly convert between various units within each category, such as:

Category	Units
Volume	Liter, Milliliter, Gallon (US), Gallon (UK), Quart (US), Quart (UK), Pint (US), Pint (UK), Cup (US), Cup (UK), Fluid Ounce (US), Fluid Ounce (UK), Tablespoon (US), Tablespoon (UK), Teaspoon (US), Teaspoon (UK)
Temperature	Celsius, Fahrenheit, Kelvin
Weight	Kilogram, Gram, Milligram, Pound, Ounce, Stone
Length	Kilometer, Meter, Centimeter, Millimeter, Mile, Yard, Foot, Inch
Time	Year, Month, Week, Day, Hour, Minute, Second
Speed	Kilometer per hour, Meter per second, Mile per hour, Knot

Chatbot

You can talk to Chat AI, a smart and friendly chatbot that can answer your questions, help you with writing, and inspire your creativity. Chat AI is powered by ChatGPT and GPT-3.5 API, which are advanced natural language processing (NLP) algorithms. You can ask Chat AI anything you want, such as:

• General knowledge questions, such as "Who is the prime minister of India?" or "What is the population of China?"
• Writing assistance, such as "Write a paragraph about dogs" or "Generate a catchy slogan for my product"
• Creative prompts, such as "Tell me a story" or "Write a poem about love"
• And more!

Here is the enhanced text:

Installation

Toolz is an amazing app that helps you with various tasks and makes your life easier. It has two main features: a chatbot and a unit converter. To install Toolz on your Android device, follow these simple steps:

Prerequisites

• Make sure your device is running Android OS version Lolypop or above. The minimum API level required is 21.
• Ensure you have enough storage space on your device to download and install the app.

Download

• Go to the Google Play Store and search for Toolz or click on the link below:

  

• Tap on the Install button and wait for the app to download and install on your device.

• Once the installation is complete, you can launch the app from your home screen or app drawer.

Build and run the project

If you are a developer and want to build and run the Toolz app from the source code, you need to follow these additional steps:

Prerequisites

• Install Android Studio Alpha (Hedgehog) or above on your machine. You can download it from here: https://developer.android.com/studio/preview
• Install Git on your machine. You can download it from here: https://git-scm.com/downloads

Steps

To build the Toolz app, follow these steps:

1. Clone the repository: Open a terminal window and type the following command: git clone https://github.com/prime-zs/toolz2.git
2. Add the private file:

Some features and functionalities of the app require a private file that contains some keys and ids. To add this file to the project, do the following:

• Create a file named Private.kt in the package com.prime.toolz.core.billing.
• Paste the following code into the file:

package com.prime.toolz.core.billing

object Private {
    /**
     * Base64-encoded RSA public key to include in your app binary
     */
    const val PLAY_CONSOLE_PUBLIC_KEY = "replace_this_with_id"
    const val UNITY_APP_ID = "replace_this_with_id"
}

object Product {
    const val DISABLE_ADS = "replace_this_with_id"
}

object Placement {
    const val INTERSTITIAL = "replace_this_with_id"
    const val BANNER_SETTINGS = "replace_this_with_id"
    const val BANNER_UNIT_CONVERTER = "replace_this_with_id"
}

Note: Replace the placeholders replace_this_with_id with the appropriate values for your app. You can get these values from the Play Console, Unity Dashboard, or other sources.

3. Open Android Studio and select Open an existing project.
4. Navigate to the folder where you cloned or downloaded this repository and select it.
5. Wait for Android Studio to sync the project and resolve the dependencies.
6. Run the app on an emulator or a connected device by clicking the Run button.

You have successfully built and run the Toolz app from the source code. Enjoy!

Support and Contribution

I love it when people use my tool and we’d love to make it even better. If you like this tool and want to support me in developing more free tools for you, I’d really appreciate a donation. Feel free to buy me a cup of coffee 😄. Thanks!

Bug Reports and Feature Requests

If you encounter any issues or have ideas for new features, please create an issue on the GitHub repository.

Architecture

This app uses MVVM (Model View View-Model) architecture.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Contact

• If you have any questions, feedback, or suggestions, please feel free to contact me at [email protected]. You can also follow me on GitHub @prime-zs. Thank you for using Toolz! 🙏
• Twitter: @ZakirSheikhReal