Colorful

Colorful is a dynamic theme library allowing you to change your apps' color schemes easily.

This fork

This fork only adds feature to change color of buttons.

License

Colorful is licensed under the Apache 2.0 License, in common Android style.

Copyright 2016 Garret Yoder

Installation

Add jitpack to your maven sources

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

Add Colorful as a dependency to your build.gradle

dependencies {
    compile 'com.github.connected963:Colorful:1.8'
}

Usage

In your Application class, you must initialize Colorful

public class SampleApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        Colorful.init(this);
    }
}

Any Activity you wish to be themed must extend from ColorfulActivity

public class MainActivity extends ColorfulActivity

Or, if you do not want override your theme

public class MainActivity extends ColorfulActivityKeepTheme

Alternatively you can call the following method after super.onCreate(savedInstanceState); and before setContentView();

Colorful.applyTheme(Activity activity);

You can also use Colorful.applyTheme(Activity activity, Boolean overrideBase); where overrideBase defines whether you want Colorful to override your base theme as well, or simply set the primary and accent colors. This allows you to use Colorful with your own pre-defined style, but will break light/dark functionality.

You can set the default theme colors Colorful will use with the defaults() method

public class SampleApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        Colorful.defaults()
                .primaryColor(Colorful.ThemeColor.RED)
                .accentColor(Colorful.ThemeColor.BLUE)
                .translucent(false)
                .dark(true);
        Colorful.init(this);
    }
}

You can set the colors at any time using the config method

Colorful.config(this)
                .primaryColor(Colorful.ThemeColor.RED)
                .accentColor(Colorful.ThemeColor.BLUE)
                .translucent(false)
                .dark(true)
                .apply();

After which you must call apply(); to save your changes

Colorful will handle saving and loading your theme preferences for you.

You can setup the colors of buttons adding the call

    .buttonColor(Colorful.ButtonColor.of(Colorful.ThemeColor.ORANGE))

on your config method call (before apply(); call)

Colorful.config(this)
                .primaryColor(Colorful.ThemeColor.RED)
                .accentColor(Colorful.ThemeColor.BLUE)
                .buttonColor(Colorful.ButtonColor.of(Colorful.ThemeColor.ORANGE))
                .translucent(false)
                .dark(true)
                .apply();

Besides that, you must to change button background to @drawable/colorful_button. You can do this on every button that should be customized, or customizing your theme.

Android sdk V 21+

Customizing your app theme:

    <style name="AppTheme" parent="...">
        ...
        <!-- Customize your theme here. -->
        <item name="buttonStyle">@style/AppTheme.Button</item>
        ...
    </style>
    ...
    <style name="AppTheme.Button" parent="...Button">
        <item name="android:background">@drawable/colorful_button</item>
    </style>

Customizing only one button:

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:background="@drawable/colorful_button"
        android:text="Button" />

Android SDK V 21-

Customizing your app theme:

    <style name="AppTheme" parent="...">
        ...
        <!-- Customize your theme here. -->
        <item name="buttonStyle">@style/AppTheme.Button</item>
        ...
    </style>
    ...
    <style name="AppTheme.Button" parent="...Button">
        <item name="android:background">?attr/colorful_button</item>
    </style>

Customizing only one button:

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:background="?attr/colorful_button"
        android:text="Button" />

Color Chooser

Colorful has a inbuilt color chooser dialog that will return a ThemeColor object you can pass directly to Colorful

public class MainActivity extends CActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        setSupportActionBar(((Toolbar) findViewById(R.id.toolbar)));

        ColorPickerDialog dialog = new ColorPickerDialog(this);
        dialog.setOnColorSelectedListener(new ColorPickerDialog.OnColorSelectedListener() {
            @Override
            public void onColorSelected(Colorful.ThemeColor color) {
                //TODO: Do something with the color
            }
        });
        dialog.show();
    }
}

Preference Item

Colorful has a inbuilt preference item that will automatically set Colorful's colors.

Use colorpicker:primary_color and colorpicker:accent_color to tell Colorful which value to set.

        <org.polaric.colorful.ColorPickerPreference
            android:title="@string/primary_color"
            android:summary="@string/primary_color_desc"
            colorpicker:primary_color="true"/>

        <org.polaric.colorful.ColorPickerPreference
            android:title="@string/accent_color"
            android:summary="@string/accent_color_desc"
            colorpicker:accent_color="true"/>

Screenshots