Paper Icon Theme
================

Paper is a modern freedesktop icon theme whose design is based around the use of bold colours and simple geometric shapes to compose icons. Each icon has been meticulously designed for pixel-perfect viewing.

While it does take some inspiration from the icons in Google's Material Design, some aspects have been adjusted to better suit a desktop environment.

## Copying or Reusing

Paper is licenced under the terms of the [Creative Commons Attribution-ShareAlike](https://creativecommons.org/licenses/by-sa/4.0/). When reusing this work be sure to include a proper attribution:

> "[Paper Icons](http://snwh.org/paper/icons)" by [Sam Hewitt](http://samuelhewitt.com/) is licensed under [CC-SA-4.0](http://creativecommons.org/licenses/by-sa/4.0/)

Software that is included is free software; you can redistribute it and/or modify it under the terms of the [GNU Lesser General Public License](https://www.gnu.org/licenses/lgpl-3.0.txt)

## Downloading Paper

Download instructions are available on the [official site](https://snwh.org/paper/download).

### Build & Install

You can build and install the Paper icon themes from source, provide you have ```gnome-common``` installed on your system.

    ./autogen.sh
    make
    sudo make install

## Missing Icons & Requests

You can file an icon request as a [GitHub issue](https://github.com/snwh/paper-icon-theme/issues/new). Filing an icon request or reporting a missing icon, please take care in providing the following useful information: 

 - A screenshot of your issue or an image of the original icon you are requesting to be themed
 - The file name for the missing icon or the requested icon, for example `gimp.png` or `system-shutdown.svg`
 - A short description of the application or software that you are requesting an icon for.

Note: some software ships hardcoded icons, meaning when you install icons are not placed in the system-wide directory `/usr/share/icons` which makes them unthemeable.

## Help & Support

You can visit the support channel `#Paper-Chat` on Freenode for questions or discussion. The development of Paper is in part supported by [Patreon](http://patreon.com/snwh/), pledges are much appreciated. 😊