Home

Awesome

Icon picker dialog

A fully customizable icon picker dialog that provides easy access to quality icons without having to include them individually in your project. Icons are bundled in icon packs, which are distributed as separate artifacts. Icon packs are defined by XML, each icon consisting of an ID, a SVG path, a viewport size, a category and a list of tags for searching.

<img src="screenshots/demo1.gif" width="40%" alt="Demo 1"/> <img src="screenshots/demo2.gif" width="40%" alt="Demo 2"/>

Gradle dependency

implementation 'com.maltaisn:icondialog:X.Y.Z'

Replace X.Y.Z with lastest version number: Download

The mavenCentral() repository is required.

Notes

Icon packs

The following icon packs are available as of lastest version.

NameDependency<sup>1</sup>VersionIconsSize<sup>2</sup>Languages
DefaultdefaultLastest version1,045304 kB6 languages
Font Awesomefont-awesomeLastest version996225 kBEnglish
Community Materialcommunity-materialLastest version3,941555 kBEnglish

Note that the process to update some icon packs (MDI, Font Awesome) is automated and icons might be deleted either on purpose or by mistake. Make sure to always handle null icon values when obtaining an icon by ID!

<sup>1</sup> Dependency uses the following pattern com.maltaisn:iconpack-<NAME>:X.Y.Z, where <NAME> is the name indicated in the table and X.Y.Z is the version. Icon packs use the same version as original icons.

<sup>2</sup> As seen in Android Studio's APK analysis, includes icons and tags.

More packs can be added on request. Custom packs and third-party icon packs can easily be created as well.

Usage

Translation

Some icon packs are not meant to be translated. These icon packs are auto-generated from files provided by the people who manage the original icon collection. Tags don't make any sense in a language other than in English, and thus cannot be translated. The scripts used for auto-generation are available in the utils module.

The default pack tags can be translated. With over 1,000 labels it takes between 3 and 5 hours to translate (in my experience). A collection of images with the icons for each label can be downloaded here to help with translation.

Changelog

View changelog for the library release notes. Each icon pack module also have their own changelog.

Licenses

Credits