README.md

   1 ![KVIrc logo](https://raw.githubusercontent.com/kvirc/KVIrc/master/data/icons/128x128/kvirc.png "KVIrc - The visual IRC client for the masses!")
   2
   3 ## About
   4 Welcome to the official Git repository for KVIrc themes.
   5 Share your KVIrc themes with your fellow users.
   6
   7 We are looking for theme authors to submit fresh new themes compatible with KVIrc **4.9.2** and to revamp existing themes and submit them back here.
   8
   9 ### Theme submission
  10
  11 The themes should be in a **UNPACKED** form, the directories that
  12 KVIrc produces by a simple *Save Theme* operation.
  13
  14 - [Fork this repository](https://github.com/kvirc/kvirc-themes/for/) and submit your theme(s) via a [pull request](https://help.github.com/articles/using-pull-requests/).
  15
  16 - [Contributing to a KVIrc repository](https://github.com/kvirc/KVIrc/wiki/Contributing-code-to-KVIrc's-repository)
  17
  18 ### Themes and icon / artwork licensing
  19
  20 All works submitted to KVIrc themes repository should contain an accompanying licence.
  21 Especially if your theme includes user made icons or artwork or that has been sourced by you for inclusion. :boom:
  22
  23 As the author of the work, you have complete freedom to choose what licensing model which
  24 best suits you and the works submitted.
  25
  26 We recommend [Open Source](http://opensource.org/licenses/category) compatible licences, and in the cases where you don't specify a licence,
  27 you understand that the default **[GPLv2](http://opensource.org/licenses/GPL-2.0)** licence is automatically applied to your submission once its merged.
  28
  29 :boom: If you are not the author of the icons or artwork included with your themes, please ensure you are respecting the authors copyright or any licensing terms and have permission to use and redistribute their works and include such licences with your submission.
  30
  31 ### Inclusion of icons
  32
  33 Currently KVIrc has a complete set of **[337 coresmall icons](https://github.com/kvirc/KVIrc/blob/master/src/kvirc/kernel/KviIconManager.h#L506)** plus around **60** large icons and other buttons and a many other varied images.
  34
  35 By default the *Save Theme* operation will optionally copy the core icons into your theme's directory where none exist.
  36
  37 Themes without any icons will automatically use the default core icon set for KVIrc.
  38 We recommend this if you intend to use core icon set and automatically use any improved icons submitted to core.
  39
  40 Any specific icons you submit with your theme are automatically loaded preferentially over the **core** icons they intend to replace.
  41
  42 ### Support
  43
  44 * [Open an issue or submit a suggestion](https://github.com/kvirc/kvirc-themes/issues/new)
  45 * Chat with us via IRC [#KVIrc](https://webchat.freenode.net/?nick=kvirc-user&channels=%23kvirc&prompt=1&uio=OT10cnVlde) on the freenode network
  46
  47 ### Quick links
  48
  49 * [KVIrc development](https://github.com/kvirc/KVIrc)
  50 * [KVIrc scripts](https://github.com/kvirc/kvirc-scripts)
  51 * [KVIrc website repository](https://github.com/kvirc/kvirc-www)