Lüv FAQ

What is Lüv?

Baby don't hurt me, don't hurt me, no more.

Lüv is an icon theme for freedesktop environments like Gnome, Plasma, XFCE, Mate, etc.

Its name is pronounced as Love.

It features colors from Google’s Material Design color palette but they're not Material Design icons. These icons do not follow the Material Design guidelines; they have their own. So please do not refer to them as such.

Releases

The latest release is version 0.4 - that is the latest release but the repository is updated everyday with the occassional time off on weekends.

Releases are tagged when there's enough portions of the theme done. It's recommended that you clone the repository rather than downloading the tagged released file if you want to enjoy the icon theme fully.

Installing and Updates

See README for install instructions. Binary packages are not available. To update simply issue the command git pull where you've cloned the repository.

Tip: Clone the repository and create links in /usr/share/icons or ~/.icons or ~/.local/share/icons pointing to the folders from your local clone and use the command git pull to update the theme.

Creating New Issues

Lüv works on every desktop that follows the freedesktop standards.

• If an icon is blurry, it's missing. Report it.
• if an icon is the default application icon, it's missing. Report it.
• If an icon is from the environment default icons like Adwaita, Breeze or Oxygen, it's missing. Report it.

If you find any of those cases read the README to properly report a missing icon.

• if the icon is in the theme and it's still not showing up please contact the developer of that software and kindly suggest to not use absolute paths in their launchers. You may use Hardcoded Icon Fixer to resolve this problem in the meantime.

It's very important that issues have all of the information listed in the README. If your issue doesn't have all the information required it won't be fixed.

Completeness

Lüv will eventually contain icons for all desktop environments; all recent versions that is. That basically means three things:

• No.1: Lüv will not have a bazillion icons. Many of those icons are no longer needed by the recent versions of said desktop environments.
• No.2: Lüv won't ship with 6 versions (sizes) of some icons, why? because doing that makes developers not use icons properly, using an icon from the /actions folder as an application icon or vice versa because "it works" is bad practice. Icons should be selected depending on where they will be used in the interface and not at random.
• No.3: The icons that are added to the theme are exactly those that are required. No more no less.

Using it in GTK 3 Systems

Gnome Shell, Cinnamon, Budgie and Pantheon use symbolic icons. Lüv ships with symbolic icons but they're not used by default. You can enable them by opening the index.theme file inside Lüv and Lüv Dark, scrolling to the bottom of the file and following the instructions there.

Using it in GTK 2 Systems

No extra steps needed.

Using it in Qt Systems

No extra steps needed.

Contributions

You can begin to contribute icons to the icon theme by following the Documentation in the wiki.

If you have an icon to contribute to the theme create a pull request. This is the only way we can review your work. If you have doubts about the Documentation create an issue.

Licensing and Distribution

This icon theme is licensed under the Creative Commons Attribution-ShareAlike 4.0 International. This license allows you to:

• Share — copy and redistribute the material in any medium or format
• Adapt — remix, transform, and build upon the material

Under the following terms:

• Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
• ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

Not version 3.0, not GPL, not LPGL, not BY-NC or any other license. It should be the same license. If you fail to comply with this Public License, then your rights under this Public License terminate automatically.

The full license text is included in the LICENSE file inside the theme's folders and should be included in distributed packages.

The wallpapers included in the repository are also licensed under the Creative Commons Attribution-ShareAlike 4.0 International.

Visit this link to know how to properly give Attribution.

Derivatives

The license as explained above allows you to do whatever you want as long as you comply with its terms but we strongly and fully recommend that you follow the provided Documentation to create derivative work since we would like that derivative works tried to maintain the same standard of quality that we've set for the theme ourselves.

Notes

• Lüv is only available in SVG form and there are no plans to export it to raster images like PNGs.
• Lüv is a production-ready icon theme and there's no need for compiling or building at all.
• Lüv is free and gratis artwork but living costs are not. If you are able, please, consider sponsoring its development. You can do so by going here: http://uriherrera.com/sponsor/ and selecting an amount you're comfortable with.
• If you're looking for Flattr it's available to download from here.