KDE TechBase - User contributions [en]

Projects/Oxygen/Missing Icons

2008-02-22T15:44:37Z

Djmdave: /* General purpose icons */ transform-scale = done

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || Done (in playground/scribus) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || Done || ruphy
|-----
|| mimetypes/application-x-chm || Icon for *.chm (application/x-chm). || No ||
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| media-optical-video || icon for DVDs and video CDs, from [http://websvn.kde.org/trunk/KDE/kdelibs/solid/solid/backends/hal/haldevice.cpp?view=markup HalDevice::icon] ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdelibs || phonon || actions/player-volume-muted || This is needed by all Phonon related apps, that show a mute/unmute button near to the volumeslider. || No ||
|-----
|| kdebase || konqueror || actions/edit-undo-close-tab || konqueror undo closed tab [jpetso says: low priority, has a fallback to edit-undo] || No ||
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || kickoff || actions/system-shutdown || Shutdown (Turn off the computer) || Done ||
|-----
|| kdebase || kickoff || actions/system-reboot || Restart (restart the computer) || Done || Pinheiro
|-----
|| kdebase || kickoff || actions/system-suspend and system-suspend-hibernate || Hibernate || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || actions/window-duplicate || An icon to duplicate the current window so that the new window contains the same contents as the current one. Probably keep it visually similar to the "tab-duplicate" icon. || Done || jpetso
|-----
|| kdebase || kwrite || apps/preferences-plugin-word-completion-ktexteditor || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || In progress || Pinheiro
|-----
|| kdebase || drkonqi || apps/drkonqi || icon for the kde crash manager ||No ||
|-----
|| kdenetwork || kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| kdegraphics || okular || actions/view-table-of-contents-ltr / view-table-of-contents-rtl || An icon (in both LtR and RtL versions) representing the table of contents. To be used for indicating the "Contents" tab in the okular sidebar. || No ||
|-----
|| koffice || koffice icons || (various) See http://wiki.koffice.org/index.php?title=Icons || various. icon names listed there are badly broken at the moment, take that wiki with a grain of salt. ||No ||
|-----
|| koffice || kthesaurus || apps/kthesaurus - {{bug|49983}} || application icon for the application that suggests similar words for a given one || No ||
|-----
|| koffice || Text Tool || plugins/textshape || Icons to replace the text on the tabs: one for formatting, one for paragraph styles, one for character styles, one for bullet settings. (perhaps some Abc in rich text, the paragraph sign, the T symbol and a bullet icon -- these icons will not be used on buttons or in toolbars) || No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon for [Kig http://edu.kde.org/kig/] (kdeedu/kig/kig), a geometrical drawing program. || No ||
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress (jpetso: done already?) || Leeo
|-----
|| kdepim || kmail || mail-download-now || See [http://img169.imageshack.us/my.php?image=snapshot1sn2.png this screenshot]. The icon is displayed on the column header for the pop filter dialog. If the user clicks the radiobutton of the icon's column, the message will be downloaded with the current mail check.|| No ||
|-----
|| kdepim || kmail || mail-download-later || See [http://img169.imageshack.us/my.php?image=snapshot1sn2.png this screenshot]. The icon is displayed on the column header for the pop filter dialog. If the user clicks the radiobutton of the icon's column, the message will not be downloaded with the current mail check. The user still can download the message with a later mail check. || No ||
|-----
|| kdepim || kmail || kmmsgfullyencrypted || Status icon, displayed in the message list. Indicates that the whole message is encrypted. || No ||
|-----
|| kdepim || kmail || kmmsgpartiallyencrypted || Status icon, displayed in the message list. Indicates that some parts of the message is encrypted (for example, the body text is encrypted, but an attachment is not). || No ||
|-----
|| kdepim || kmail || kmmsgundefinedencrypted || Status icon, displayed in the message list. Indicates that it is not known if the message is encrypted. || No ||
|-----
|| kdepim || kmail || kmmsgencryptionproblematic || Status icon, displayed in the message list. Indicates that the message is encrypted, but there is some problem with it.|| No ||
|-----
|| kdepim || kmail || kmmsgsignatureproblematic || Status icon, displayed in the message list. Indicates that the message is encrypted, but there is some problem with the signature (for example, the key might be expired). || No ||
|-----
|| kdepim || kmail || actions/mail-mark-junk || Action to mark one or more mails as spam (= junk). [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || online_status || Used for both the "Work Online" and "Work Offline" actions. || No ||
|-----
|| kdepim || kmail || addressee-distributionlist (or something like that) || KMail has an addressee selector, where you can select the receivers of the mail you write. Each addressee has a little icon which indicates whether that addressee is a single person or a group of persons (also named distribution list). The old icon for this was kontact_contacts, and showed three heads. The other icon for a single person shows a single head (user-identity, not the best choice probably, but there is nothing else). No || No ||
|-----
|| kdepim || kmail || actions/mail-message-new-list || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". [jpetso says: low priority, mail-message-new already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail-reply-custom || Action to reply to a message with a custom template (made by the user). Note that there either is no fallback or the fallback does not work. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || korganizer || apps/office-calendar || The icon for the KOrganizer program || Done ||
|-----
|| kdepim || korganizer || actions/appointment-new || The icon for the "New Event" action. Very important, and even in the icon naming spec. || No ||
|-----
|| kdepim || korganizer || actions/task-new || The icon for the "New Todo" action. || No ||
|-----
|| kdepim || korganizer || actions/journal-new || The icon for the "New Journal" action. I guess view-pim-journal overlayed with the plus icon should do. || No ||
|-----
|| kdepim || korganizer || actions/address-book-open || An icon for viewing, opening or selecting from an address book. Also used somewhere else (KAlarm, I believe), and combined with a plus icon it would be possible to get the specified address-book-new icon. || No ||
|-----
|| kdepim || korganizer || apps/preferences-calendar-freebusy || An icon for configuring free/busy time. || No ||
|-----
|| kdepim || korganizer || status/appointment-recurring || An icon to show a recurring event. || No ||
|-----
|| kdepim || korganizer || status/task-recurring || An icon to show a recurring to-do. || No ||
|-----
|| kdepim || korganizer || status/task-complete || An icon to show a completed to-do. || No ||
|-----
|| kdepim || korganizer || status/task-inprogress || An icon to show a to-do is in-progress to being completed. || No ||
|-----
|| kdepim || korganizer || status/task-needsattention || An icon to show a to-do needs attention or action. || No ||
|-----
|| kdepim || korganizer || status/appointment-reminder || An icon for an event with a reminder. || No ||
|-----
|| kdepim || korganizer || status/task-reminder || An icon to show a to-do with a reminder. || No ||
|-----
|| kdepim || korganizer || action/meeting-attending || An icon to show that you will attend a meeting || No ||
|-----
|| kdepim || korganizer || action/meeting-attending-tentative || An icon to show that you are tentatively scheduled to attend a meeting || No ||
|-----
|| kdepim || korganizer || status/meeting-organizer || An icon to show that you are the person who organized and is in charge of a meeting || No ||
|-----
|| kdepim || korganizer reminder daemon || korgac || An icon for the KOrganizer reminder daemon that is used almost exclusively in the system tray || No ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || No ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || No ||
|-----
|| kdepim || kontact || planner || to represent a daily planner (show your appointments, stuff to-do, meetings, etc in an organized way) || No ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || No ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || No ||
|-----
|| kdepim || kitchensync || actions/sync-start || The action to initiate a synchronization between to devices. || No ||
|-----
|| kdepim || akregator || actions/feed-fetch || The action to fetch a newsfeed (RSS, Atom, ...), quite similar to fetching mails actually. [jpetso says: low priority, probably post-4.0 stuff - they're already using icons that are not too far off) || No ||
|-----
|| kdepim || akregator || actions/feed-fetch-all || The action to fetch all newsfeeds (RSS, Atom, ...). [jpetso says: low priority, probably post-4.0 stuff - they're already using icons that are not too far off) || No ||
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kfourinline || kfourinline || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdenetwork || kget || status/network-connecting || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || apps/im-aim || Icon for the AIM instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-icq || Icon for the ICQ instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-jabber || Icon for the XMPP/Jabber instant messaging protocol || Yes || johann_ol
|-----
|| kdenetwork || kopete || apps/im-msn || Icon for the MSN instant messaging protocol || Yes || johann_ol
|-----
|| kdenetwork || kopete || apps/im-yahoo || Icon for the Yahoo! instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || more protocol icons [jpetso: no time for retrieving the whole list right now] || Icon for the [blah blah blah] instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/preferences-desktop-user-privacy || Configuring privacy settings || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-plugin-text-effect-kopete || Configuring text formatting special effects || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-autocorrection || Configuring text autocorrect rules || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-highlighting || Configuring text highlighting - icon exists but only in a low resolution || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-pipes || Configuring piping settings - Probably like the old 'pipe' icon || No ||
|-----
|| kdenetwork || kopete || status/dock-kopete-flashing || icon flashed in system tray when new messages are received || No || davigno
|-----
|| kdesdk || kapptemplate || apps/kapptemplate || generates KDE 4 templates to start programming || No ||
|-----
|| kdeutils || kjots || actions/insert-horizontal-rule || icon for inserting a horizontal rule line (for the HTML <hr> tag) such as [http://www.yu.edu/cms/uploadedImages/MIS_ANS/Academic_Computing/ANGEL/clip_image013.jpg this] ||No ||
|-----
|| kdebase || plasma || plasma's toolbox || Toolbox icon to replace the wrench icon. The toolbox (on the top right of the desktop, remember all the screenshots) will allow users to zoom in and out of the desktop, add widgets, configure the desktop, lock the desktop, run commands, etc. From what I understand it's a replacement of the right click menu. Several plasma developers suggested a 2D palette similar to plasma's techbase icon. ~Craig || No ||
|-----
|| kdebase || plasma || battery.svg || Battery applet uses battery to present different types of batteries. We would need overlay's in svg, similar as existing AC adaptor indicator, that could be used to present different types of icons. We need indicators for following types: primary/notebook (no indicator is OK), mouse, keyboard, mouse+keyboard (not sure if used), pda. ||
|-----
|| kdeaccessibility || ktts || apps/ktts(d?).png || App icon for ktts is needed, and will be used for kttsmgr in menus, and for "Speak Page" icon in konq toolbar. Will probably also likely be used for ktts settings in accessibility system-settings page. Old icon was a parrot which fits I think. ||
|-----
|}

== Applications in Playground ==
For apps in trunk/playground/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
||games||kollision||kollision||App main icon ([http://commit-digest.org/issues/2007-04-15/files/kollision2.png screenshot]). Now in kdereview.||||
|-----
||network||kopete-bonjour||bonjour_protocol||The icons to be replaced are here: playground/network/kopete/protocols/bonjour/icons.||||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/view-history ||
|-----
|| Amarok || apps/amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No ||
|-----
|| Amarok || status/media-track-repeat || An icon for the "repeat the current track" state. || No ||
|-----
|| digiKam || application icon || An icon to be used in splash screen, tool bar, help/about, taskbar etc. [http://websvn.kde.org/trunk/extragear/graphics/digikam/data/icons/hi128-app-digikam.png Old app icon]|| <s> yes We want to change completely and get rid of the pinguin. [http://www.gerhard.fr/files/camera.svg Here] is a basig design I tried, but I'm not happy with it. Any help is higly appreciated. </s>
Done. see [http://websvn.kde.org/kde/*checkout*/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/digikam.png here]. digikam's icon has been done for a very long time - [[User:Djmdave|Djmdave]] 15:07, 10 February 2008 (CET) ||
|-----
|| KPlayer, Amarok || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No (...jpetso: used an interim copy of the playlist icon, but without nice "repeat" arrows) ||
|-----
|| KPlayer, Amarok || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| Kind of... copied the "roll" icon to that location ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer, Dragon Player || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer, Dragon Player || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || status/signature-bad || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No longer needed, using 'security-low' ||
|-----
|| ktorrent || media-playback-all-start and media-playback-all-stop || For starting and stopping torrents we want to use media-playback-start and media-playback-stop, so we would like some matching icons to start and stop all torrents. || No || Leeo
|-----
|| ktorrent || apps/preferences-system-network-ip-filter-ktorrent || Icon for KTorrent's IP Filter plugin. This is a blocklist for bad peers. || No (jpetso says: hmmm... have i replaced this with view-filter already? ...) || Leeo
|-----
|| ktorrent || apps/preferences-plugin-scan-folder-ktorrent || Icon for KTorrent's folder scanner plugin. This plugin monitors directories for torrent files, and when a new one is detected, it is loaded into ktorrent. || No || Leeo
|-----
|| ktorrent || apps/preferences-system-network-upnp-ktorrent || Icon for KTorrent's UPnP plugin. || No || Leeo
|-----
|| ktorrent || apps/preferences-system-network-discovery || Icon for KTorrent's zeroconf (DNSSD) plugin, also used by the "Network Discovery" page in the System Settings (which makes for the slightly different icon name). || No || Leeo
|-----
|| Minirok (and other media players?) || actions/list-clear || An icon for the "clear (play)list" action. Previously used "view_remove" from crystalsvg, which is now gone. || please use edit-clear - [[User:Djmdave|Djmdave]] 15:07, 10 February 2008 (CET) ||
|-----
|| [http://qlandkarte.sourceforge.net/ QLandkarte] || apps/qlandkarte || QLandkarte application (Garmin GPS tool for mapping/tracks/waypoints...) currently uses 16x16 world icon from Nuvola and author would be interested to get nice SVG icon for application. || ||
|-----
|| [http://www.kmess.org/ KMess] || Main Icon || We are porting our MSN client for KDE and we'd appreciate a lot an oxygenized version of [http://trac.kmess.org/browser/trunk/kmess/kmess/hi128-app-kmess.png our hummingbird logo] || ||
|-----
|| [http://www.kmess.org/ KMess] || MSN Status icons || If possible, oxygenized msn status icons.. it shouldn't be very long since they could be all color variants of just one image: [http://trac.kmess.org/browser/trunk/kmess/kmess/pics/online.png Online], or with very little changes: [http://trac.kmess.org/browser/trunk/kmess/kmess/pics/lunch.png Lunch] || please see user-* icons in status. if there are others that are needed, then please state them individually - [[User:Djmdave|Djmdave]] 15:07, 10 February 2008 (CET) ||
|-----
|| [http://www.kde-apps.org/content/show.php/KGrab?content=74086 KGrab] || Main Icon || Its a extragear fork of KSnapshot. At the moment i use the old Ksnapshot icon. We need a new oxygen Icon for KGrab. Tanks ||||
|-----
|| [http://qtpacman.iskrembilen.com qtPacman] || status-installed, status-notinstalled status-upgradeable action-update || We would are using the Oxygen-Icons in our program, but we can't find any status-icons which fit good :( || No ||
|-----
|}
= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

= List of missing icons with screenshot =

List of missing icons from applications with related screenshot:

http://techbase.kde.org/index.php?title=Projects/Oxygen/KDE4_Missing_Icons

Projects/Oxygen/Missing Icons

2008-02-10T14:07:10Z

Djmdave: adding comments to msn status, minirok, digikam

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || In progress (See discussion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || Done || ruphy
|-----
|| mimetypes/application-x-chm || Icon for *.chm (application/x-chm). || No ||
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| media-optical-video || icon for DVDs and video CDs, from [http://websvn.kde.org/trunk/KDE/kdelibs/solid/solid/backends/hal/haldevice.cpp?view=markup HalDevice::icon] ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdelibs || phonon || actions/player-volume-muted || This is needed by all Phonon related apps, that show a mute/unmute button near to the volumeslider. || No ||
|-----
|| kdebase || konqueror || actions/edit-undo-close-tab || konqueror undo closed tab [jpetso says: low priority, has a fallback to edit-undo] || No ||
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || kickoff || actions/system-shutdown || Shutdown (Turn off the computer) || No ||
|-----
|| kdebase || kickoff || actions/system-reboot || Restart (restart the computer) || Done || Pinheiro
|-----
|| kdebase || kickoff || actions/system-suspend and system-suspend-hibernate || Hibernate || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || actions/window-duplicate || An icon to duplicate the current window so that the new window contains the same contents as the current one. Probably keep it visually similar to the "tab-duplicate" icon. || Done || jpetso
|-----
|| kdebase || kwrite || apps/preferences-plugin-word-completion-ktexteditor || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || In progress || Pinheiro
|-----
|| kdebase || drkonqi || apps/drkonqi || icon for the kde crash manager ||No ||
|-----
|| kdenetwork || kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| kdegraphics || okular || actions/view-table-of-contents-ltr / view-table-of-contents-rtl || An icon (in both LtR and RtL versions) representing the table of contents. To be used for indicating the "Contents" tab in the okular sidebar. || No ||
|-----
|| koffice || koffice icons || (various) See http://wiki.koffice.org/index.php?title=Icons || various. icon names listed there are badly broken at the moment, take that wiki with a grain of salt. ||No ||
|-----
|| koffice || kthesaurus || apps/kthesaurus - {{bug|49983}} || application icon for the application that suggests similar words for a given one || No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon for [Kig http://edu.kde.org/kig/] (kdeedu/kig/kig), a geometrical drawing program. || No ||
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress (jpetso: done already?) || Leeo
|-----
|| kdepim || kmail || mail-download-now || See [http://img169.imageshack.us/my.php?image=snapshot1sn2.png this screenshot]. The icon is displayed on the column header for the pop filter dialog. If the user clicks the radiobutton of the icon's column, the message will be downloaded with the current mail check.|| No ||
|-----
|| kdepim || kmail || mail-download-later || See [http://img169.imageshack.us/my.php?image=snapshot1sn2.png this screenshot]. The icon is displayed on the column header for the pop filter dialog. If the user clicks the radiobutton of the icon's column, the message will not be downloaded with the current mail check. The user still can download the message with a later mail check. || No ||
|-----
|| kdepim || kmail || kmmsgfullyencrypted || Status icon, displayed in the message list. Indicates that the whole message is encrypted. || No ||
|-----
|| kdepim || kmail || kmmsgpartiallyencrypted || Status icon, displayed in the message list. Indicates that some parts of the message is encrypted (for example, the body text is encrypted, but an attachment is not). || No ||
|-----
|| kdepim || kmail || kmmsgundefinedencrypted || Status icon, displayed in the message list. Indicates that it is not known if the message is encrypted. || No ||
|-----
|| kdepim || kmail || kmmsgencryptionproblematic || Status icon, displayed in the message list. Indicates that the message is encrypted, but there is some problem with it.|| No ||
|-----
|| kdepim || kmail || kmmsgsignatureproblematic || Status icon, displayed in the message list. Indicates that the message is encrypted, but there is some problem with the signature (for example, the key might be expired). || No ||
|-----
|| kdepim || kmail || actions/mail-mark-junk || Action to mark one or more mails as spam (= junk). [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || online_status || Used for both the "Work Online" and "Work Offline" actions. || No ||
|-----
|| kdepim || kmail || actions/mail-message-new-list || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". [jpetso says: low priority, mail-message-new already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail-reply-custom || Action to reply to a message with a custom template (made by the user). Note that there either is no fallback or the fallback does not work. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || korganizer || apps/office-calendar || The icon for the KOrganizer program || Done ||
|-----
|| kdepim || korganizer || actions/appointment-new || The icon for the "New Event" action. Very important, and even in the icon naming spec. || No ||
|-----
|| kdepim || korganizer || actions/task-new || The icon for the "New Todo" action. || No ||
|-----
|| kdepim || korganizer || actions/journal-new || The icon for the "New Journal" action. I guess view-pim-journal overlayed with the plus icon should do. || No ||
|-----
|| kdepim || korganizer || actions/address-book-open || An icon for viewing, opening or selecting from an address book. Also used somewhere else (KAlarm, I believe), and combined with a plus icon it would be possible to get the specified address-book-new icon. || No ||
|-----
|| kdepim || korganizer || apps/preferences-calendar-freebusy || An icon for configuring free/busy time. || No ||
|-----
|| kdepim || korganizer || status/appointment-recurring || An icon to show a recurring event. || No ||
|-----
|| kdepim || korganizer || status/task-recurring || An icon to show a recurring to-do. || No ||
|-----
|| kdepim || korganizer || status/task-complete || An icon to show a completed to-do. || No ||
|-----
|| kdepim || korganizer || status/appointment-reminder || An icon for an event with a reminder. || No ||
|-----
|| kdepim || korganizer || status/task-reminder || An icon to show a to-do with a reminder. || No ||
|-----
|| kdepim || korganizer || action/meeting-attending || An icon to show that you will attend a meeting || No ||
|-----
|| kdepim || korganizer || action/meeting-attending-tentative || An icon to show that you are tentatively scheduled to attend a meeting || No ||
|-----
|| kdepim || korganizer || status/meeting-organizer || An icon to show that you are the person who organized and is in charge of a meeting || No ||
|-----
|| kdepim || korganizer reminder daemon || korgac || An icon for the KOrganizer reminder daemon that is used almost exclusively in the system tray || No ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || No ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || No ||
|-----
|| kdepim || kontact || planner || to represent a daily planner (show your appointments, stuff to-do, meetings, etc in an organized way) || No ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || No ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || No ||
|-----
|| kdepim || kitchensync || actions/sync-start || The action to initiate a synchronization between to devices. || No ||
|-----
|| kdepim || akregator || actions/feed-fetch || The action to fetch a newsfeed (RSS, Atom, ...), quite similar to fetching mails actually. [jpetso says: low priority, probably post-4.0 stuff - they're already using icons that are not too far off) || No ||
|-----
|| kdepim || akregator || actions/feed-fetch-all || The action to fetch all newsfeeds (RSS, Atom, ...). [jpetso says: low priority, probably post-4.0 stuff - they're already using icons that are not too far off) || No ||
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kfourinline || kfourinline || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdenetwork || kget || status/network-connecting || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || apps/im-aim || Icon for the AIM instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-icq || Icon for the ICQ instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-jabber || Icon for the XMPP/Jabber instant messaging protocol || Yes || johann_ol
|-----
|| kdenetwork || kopete || apps/im-msn || Icon for the MSN instant messaging protocol || Yes || johann_ol
|-----
|| kdenetwork || kopete || apps/im-yahoo || Icon for the Yahoo! instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || more protocol icons [jpetso: no time for retrieving the whole list right now] || Icon for the [blah blah blah] instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/preferences-desktop-user-privacy || Configuring privacy settings || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-plugin-text-effect-kopete || Configuring text formatting special effects || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-autocorrection || Configuring text autocorrect rules || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-highlighting || Configuring text highlighting - icon exists but only in a low resolution || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-pipes || Configuring piping settings - Probably like the old 'pipe' icon || No ||
|-----
|| kdenetwork || kopete || status/dock-kopete-flashing || icon flashed in system tray when new messages are received || No || davigno
|-----
|| kdesdk || kapptemplate || apps/kapptemplate || generates KDE 4 templates to start programming || No ||
|-----
|| kdeutils || kjots || actions/insert-horizontal-rule || icon for inserting a horizontal rule line (for the HTML <hr> tag) such as [http://www.yu.edu/cms/uploadedImages/MIS_ANS/Academic_Computing/ANGEL/clip_image013.jpg this] ||No ||
|-----
|| kdebase || plasma || plasma's toolbox || Toolbox icon to replace the wrench icon. The toolbox (on the top right of the desktop, remember all the screenshots) will allow users to zoom in and out of the desktop, add widgets, configure the desktop, lock the desktop, run commands, etc. From what I understand it's a replacement of the right click menu. Several plasma developers suggested a 2D palette similar to plasma's techbase icon. ~Craig || No ||
|-----
|| kdebase || plasma || battery.svg || Battery applet uses battery to present different types of batteries. We would need overlay's in svg, similar as existing AC adaptor indicator, that could be used to present different types of icons. We need indicators for following types: primary/notebook (no indicator is OK), mouse, keyboard, mouse+keyboard (not sure if used), pda. ||
|-----
|}

== Applications in Playground ==
For apps in trunk/playground/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
||games||kollision||kollision||App main icon ([http://commit-digest.org/issues/2007-04-15/files/kollision2.png screenshot]). Now in kdereview.||||
|-----
||network||kopete-bonjour||bonjour_protocol||The icons to be replaced are here: playground/network/kopete/protocols/bonjour/icons.||||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/view-history ||
|-----
|| Amarok || apps/amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No ||
|-----
|| Amarok || status/media-track-repeat || An icon for the "repeat the current track" state. || No ||
|-----
|| digiKam || application icon || An icon to be used in splash screen, tool bar, help/about, taskbar etc. [http://websvn.kde.org/trunk/extragear/graphics/digikam/data/icons/hi128-app-digikam.png Old app icon]|| <s> yes We want to change completely and get rid of the pinguin. [http://www.gerhard.fr/files/camera.svg Here] is a basig design I tried, but I'm not happy with it. Any help is higly appreciated. </s>
Done. see [http://websvn.kde.org/kde/*checkout*/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/digikam.png here]. digikam's icon has been done for a very long time - [[User:Djmdave|Djmdave]] 15:07, 10 February 2008 (CET) ||
|-----
|| KPlayer, Amarok || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No (...jpetso: used an interim copy of the playlist icon, but without nice "repeat" arrows) ||
|-----
|| KPlayer, Amarok || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| Kind of... copied the "roll" icon to that location ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer, Dragon Player || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer, Dragon Player || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || status/signature-bad || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No longer needed, using 'security-low' ||
|-----
|| ktorrent || media-playback-all-start and media-playback-all-stop || For starting and stopping torrents we want to use media-playback-start and media-playback-stop, so we would like some matching icons to start and stop all torrents. || No ||
|-----
|| ktorrent || apps/preferences-system-network-ip-filter-ktorrent || Icon for KTorrent's IP Filter plugin. This is a blocklist for bad peers. || No (jpetso says: hmmm... have i replaced this with view-filter already? ...) ||
|-----
|| ktorrent || apps/preferences-plugin-scan-folder-ktorrent || Icon for KTorrent's folder scanner plugin. This plugin monitors directories for torrent files, and when a new one is detected, it is loaded into ktorrent. || No ||
|-----
|| ktorrent || apps/preferences-system-network-upnp-ktorrent || Icon for KTorrent's UPnP plugin. || No ||
|-----
|| ktorrent || apps/preferences-system-network-discovery || Icon for KTorrent's zeroconf (DNSSD) plugin, also used by the "Network Discovery" page in the System Settings (which makes for the slightly different icon name). || No ||
|-----
|| Minirok (and other media players?) || actions/list-clear || An icon for the "clear (play)list" action. Previously used "view_remove" from crystalsvg, which is now gone. || please use edit-clear - [[User:Djmdave|Djmdave]] 15:07, 10 February 2008 (CET) ||
|-----
|| [http://qlandkarte.sourceforge.net/ QLandkarte] || apps/qlandkarte || QLandkarte application (Garmin GPS tool for mapping/tracks/waypoints...) currently uses 16x16 world icon from Nuvola and author would be interested to get nice SVG icon for application. || ||
|-----
|| [http://www.kmess.org/ KMess] || Main Icon || We are porting our MSN client for KDE and we'd appreciate a lot an oxygenized version of [http://trac.kmess.org/browser/trunk/kmess/kmess/hi128-app-kmess.png our hummingbird logo] || ||
|-----
|| [http://www.kmess.org/ KMess] || MSN Status icons || If possible, oxygenized msn status icons.. it shouldn't be very long since they could be all color variants of just one image: [http://trac.kmess.org/browser/trunk/kmess/kmess/pics/online.png Online], or with very little changes: [http://trac.kmess.org/browser/trunk/kmess/kmess/pics/lunch.png Lunch] || please see user-* icons in status. if there are others that are needed, then please state them individually - [[User:Djmdave|Djmdave]] 15:07, 10 February 2008 (CET) ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

= List of missing icons with screenshot =

List of missing icons from applications with related screenshot:

http://techbase.kde.org/index.php?title=Projects/Oxygen/KDE4_Missing_Icons

Schedules/KDE4/4.0 Release Schedule

2008-01-04T13:36:33Z

Djmdave: move stable 4.0 tagging to passed milestones

All dates given here are subject to revision, but we will try our best to stick to them if possible.
Note that "Tagging" that the codebase is closed for this release on the date mentioned. The tarballs
and packages are then being prepared and released approximately one week later.
The KDE Release Team is acting as the coordinator for the 4.0 release.

Note the release is done in two portions: the '''KDE Development Platform 4.0''' and the '''KDE Desktop 4.0'''. See the [[#KDE_Components|KDE Components Definition]] for details what SVN modules the two portions include. Note the earlier freeze date for the platform and make sure you don't miss the deadline to get your fixes in.

Milestones help guide us toward a final release, and the '''dates are subject to change'''. For more details see our [[Schedules/KDE4/4.0_Release_Roadmap|roadmap]].

All deadlines are due 23:59 UTC, but if you need a few more hours, notify
release-team@kde.org.

If in doubt about any milestones please ask the [mailto:release-team@kde.org release team] or your module maintainer.

= KDE 4.0 Release Schedule =

== Definitions ==

=== KDE Components ===
* '''Platform''' (libraries and runtime dependencies): kdelibs, kdepimlibs, kdebase-runtime, kdebindings
* '''Workspace''' (desktop infrastructure, window manager, plasma): kdebase-workspace, extragear-plasma
* '''Applications''' (core applications): kdeaccessibility, kdeadmin, kdeartwork, kdebase-apps, kdeedu, kdegames, kdegraphics, kdemultimedia, kdenetwork, kdepim, kdesdk, kdetoys, kdeutils
* '''Desktop''': Workspace and Applications

=== Freeze States ===

* '''Soft Freeze''': no new features, bugfixes only, incomplete features are disabled
* '''Hard freeze''': as soft freeze plus: only patches which have been reviewed on the relevant mailing lists, no new or changed messages
* '''Tagging Freeze''': only allowed changes: compile fixes, reviewed fixes of blocker bugs, changes needed to build the release tarballs

== Upcoming milestones ==

These are the upcoming milestones. When they have been passed move them to the top of the [[#Past_Milestones|Past Milestones]] section.

=== 2008-01-11: Release KDE 4.0 ===
* The first stable release of the KDE 4.0 series consists of Platform 4.0.2 and Desktop 4.0.2.
* Announce release
* Make tarballs available on download servers
* Party

=== 18 January 2008: KDE 4 Launch Event ===

== Past Milestones ==

These milestone have already been passed. They are listed in reverse chronological order to keep the most recent milestones at the top of the list.

=== 2008-01-04: Tagging stable 4.0 ===
* Tag Platform 4.0.2
* Tag Desktop 4.0.2
* Create 4.0 branch
* Hard freeze on the 4.0 branch
* Tagging freeze on the branch until release tarballs are ready
* Trunk is unfrozen and open for 4.1 development

=== 2007-12-11 : Release RC 2 ===
* Announce release
* Make tarballs available on download servers

=== 2007-12-05: Tagging RC 2 ===
* Tagging freeze until tarballs are ready
* Tag Platform 4.0.1
* Tag Desktop 3.97 (RC 2)

=== 20 November 2007: Release KDE Development Platform 4.0.0 and KDE Desktop 4.0 RC 1 ===
* Announce release
* Make tarballs available on download servers

=== 14 November 2007: Tagging RC 1 ===
* Hard freeze Desktop
* Message Freeze
* Workspace interface freeze (source and binary compatibility until KDE 4.1)
* Tagging freeze until tarballs are ready
* Tag Platform 4.0.0
* Tag Desktop 3.96 (RC 1)

=== 30 October 2007: Release KDE Development Platform 4.0 RC 1 and KDE Desktop 4.0 Beta 4 ===
* Announce release
* Make tarballs available on download servers

=== October 24, 2007: KDE 4 Release Freeze ===

* Platform interface freeze (source and binary compatibility until KDE 5)
* Hard freeze Platform
* Soft freeze Desktop
* Release Freeze until release tarballs are ready (estimated two days)
* Tag Platform 3.95 (RC 1)
* Tag Desktop 3.95 (Beta 4)

=== October 8, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Beta_Cycle|Beta3]] ===
Beta 3 is prepared, initially tested and released on October 18.

=== October 8, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Beta_Cycle|KDE Development Platform frozen solid]] ===
The KDE Development Platform is frozen. For the modules that are included in the KDE Development Platform, only patches reviewed on the development lists are permitted. If in doubt, contact the release coordinator. The ''KDE Development Platform'' covers kdesupport, kdelibs, kdepimlibs, kdebase/runtime and kdebindings (Ruby and Python bindings only).

=== August 29, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Beta_Cycle|Beta2]] ===
[http://dot.kde.org/1189078926/ Beta 2] is prepared and released after some initial testing.

Trunk is frozen for feature commits. i18n string changes are allowed.

=== July 26, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Beta_Cycle|Beta1]] ===
Beta 1 is prepared and released after some initial testing.

=== July 24, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Core_Library_API_Freeze|Core Library Freeze]] ===
The core library APIs are frozen solid.

=== June 27, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Alpha2_Release|Alpha2 Tagging]] ===
The Alpha2 will be source only -- without translations.

=== June 1, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Module_Freeze|trunk/KDE is module frozen]] ===
Trunk is frozen for new or resurrected applications.

A list of main modules that will be included in the final release will be made.

=== May 3, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Alpha_Release_Tagged|Alpha Tagging]] ===
The Alpha will be source only -- without translations.

=== May 1, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_kdelibs_Soft_API_Freeze|kdelibs Soft Freeze]] ===
The kdelibs API is "soft-frozen", meaning that changes can be made but only with the consent of the core developers.

=== April 2, 2007: [[Schedules/KDE4/4.0_Release_Roadmap#Milestone:_Subsystem_Freeze|Subsystem Freeze]] ===
From this date forward, no new KDE subsystem or major changes can be committed to kdelibs.

The buildsystem requirements (i.e. cmake version) are fixed.

=== February 2007: Technical Preview 3 ===
The [http://dot.kde.org/1172249109/ third technical preview], a developer release.

The kdelibs API will remain as stable as possible after that, so that application developers (in particular those not having their code in the KDE SVN) can start porting towards a stable kdelibs API.

Of course the applications in the KDE SVN will have been ported all along, and it will possible to alpha-test them at this stage.

=== November 2006: Technical Preview 2 ===
The [http://dot.kde.org/1162475911/ second technical preview], a developer release.

=== August 2006: Technical Preview 1 ===
The [http://dot.kde.org/1155935483/ first technical preview], a developer release.

Projects/Oxygen/Missing Icons

2007-12-31T16:49:14Z

Djmdave: /* KDE main modules */ marked mail-folder-sent as done

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/edit-clear || This is currently an empty text-edit box (like edit-rename, btw), but should be a general icon for clearing texts, lists, browser caches... anything! We want people to use this icon because it's great, but they'll only use it when they get the message. Most (if not all) other icon themes use a broom here, so we might stick to that metaphor. || No ||
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || In progress (See discussion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || In progress (will be copyied from the cursor theme) || ruphy
|-----
|| mimetypes/application-x-chm || Icon for *.chm (application/x-chm). || No ||
|-----
|| actions/help-hint || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail [jpetso says: I think it would be appropriate to have the same metaphor for this and the games-hint icon (which should be named help-hint-game anyways)] || Done || davigno
|-----
|| apps/preferences-plugin || icon to show that there are plugins to enable, for example in a configuration dialog || Done || davigno
|-----
|| actions/edit-select-all || An icon for the "select all" action. Used in Parley and Ark, at least. Also specified in the naming spec, so... we should really have that one. || Done || davigno
|-----
|| actions/view-sort-descending || An icon for sorting lists in descending order (for example, from A-Z, 1-100, etc.). Used in KAddressBook for the "Show Jump Bar", but apart from that it's also specified in the naming spec. So, rather important. || Yes || dmiller
|-----
|| actions/view-sort-ascending || An icon for sorting lists in ascending order (for example, from Z-A, 100-1, etc.). Not currently used as far as I know, but should be easy to do once the corresponding view-sort-descending icon has been drawn. Also specified in the naming spec. || Yes || dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| media-optical-video || icon for DVDs and video CDs, from [http://websvn.kde.org/trunk/KDE/kdelibs/solid/solid/backends/hal/haldevice.cpp?view=markup HalDevice::icon] ||No ||
|-----
|| mimetypes/application-rtf mimetypes/text-rtf || icon for rtf documents || Done (copied from text-enriched) || jpetso
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || actions/edit-undo-close-tab || konqueror undo closed tab [jpetso says: low priority, has a fallback to edit-undo] || No ||
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || kickoff || actions/system-shut-down || Shutdown (Turn off the computer) || No ||
|-----
|| kdebase || kickoff || actions/system-reboot || Restart (restart the computer) || No ||
|-----
|| kdebase || kickoff || actions/system-suspend and system-suspend-hibernate || Hibernate || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite || actions/window-duplicate || An icon to duplicate the current window so that the new window contains the same contents as the current one. Probably keep it visually similar to the "tab-duplicate" icon. || Done || jpetso
|-----
|| kdebase || kwrite || apps/preferences-plugin-word-completion-ktexteditor || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || In progress || Pinheiro
|-----
|| kdebase || drkonqi || apps/drkonqi || icon for the kde crash manager ||No ||
|-----
|| kdenetwork || kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| kdegraphics || okular || table-of-contents-ltr / table-of-contents-rtl || An icon (in both LtR and RtL versions) representing the table of contents. To be used for indicating the "Contents" tab in the okular sidebar. || No ||
|-----
|| koffice || koffice icons || (various) See http://wiki.koffice.org/index.php?title=Icons || various. icon names listed there are badly broken at the moment, take that wiki with a grain of salt. ||No ||
|-----
|| koffice || kthesaurus || apps/kthesaurus - {{bug|49983}} || application icon for the application that suggests similar words for a given one || No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon for [Kig http://edu.kde.org/kig/] (kdeedu/kig/kig), a geometrical drawing program. || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || actions/mail-mark-junk || Action to mark one or more mails as spam (= junk). [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-unread-new || Action to mark one or more already viewed mails as new, can be found by right-clicking a mail message in KMail || Done || jpetso
|-----
|| kdepim || kmail || actions/mail-mark-task || Action to mark one or more mails as to-do ("Mark Message as Action Item"), can be found by right-clicking a mail message in KMail || No ||
|-----
|| kdepim || kmail || places/mail-folder-sent || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-message-new-list || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". [jpetso says: low priority, mail-message-new already exists as fallback.] || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || korganizer || apps/korganizer || The icon for the KOrganizer program || No ||
|-----
|| kdepim || korganizer || actions/appointment-new || The icon for the "New Event" action. Very important, and even in the icon naming spec. || No ||
|-----
|| kdepim || korganizer || actions/task-new || The icon for the "New Todo" action. || No ||
|-----
|| kdepim || korganizer || actions/journal-new || The icon for the "New Journal" action. I guess view-pim-journal overlayed with the plus icon should do. || No ||
|-----
|| kdepim || korganizer || actions/address-book-open || An icon for viewing, opening or selecting from an address book. Also used somewhere else (KAlarm, I believe), and combined with a plus icon it would be possible to get the specified address-book-new icon. || No ||
|-----
|| kdepim || korganizer || apps/preferences-calendar-freebusy || An icon for configuring free/busy time. || No ||
|-----
|| kdepim || korganizer || status/appointment-recurring || An icon to show a recurring event. || No ||
|-----
|| kdepim || korganizer || status/task-recurring || An icon to show a recurring to-do. || No ||
|-----
|| kdepim || korganizer || status/task-complete || An icon to show a completed to-do. || No ||
|-----
|| kdepim || korganizer || status/appointment-reminder || An icon for an event with a reminder. || No ||
|-----
|| kdepim || korganizer || status/task-reminder || An icon to show a to-do with a reminder. || No ||
|-----
|| kdepim || korganizer || action/meeting-attending || An icon to show that you will attend a meeting || No ||
|-----
|| kdepim || korganizer || action/meeting-attending-tentative || An icon to show that you are tentatively scheduled to attend a meeting || No ||
|-----
|| kdepim || korganizer || status/meeting-organizer || An icon to show that you are the person who organized and is in charge of a meeting || No ||
|-----
|| kdepim || korganizer reminder daemon || korgac || An icon for the KOrganizer reminder daemon that is used almost exclusively in the system tray || No ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || No ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || No ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || No ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || No ||
|-----
|| kdepim || kitchensync || actions/sync-start || The action to initiate a synchronization between to devices. || No ||
|-----
|| kdepim || akregator || actions/feed-fetch || The action to fetch a newsfeed (RSS, Atom, ...), quite similar to fetching mails actually. [jpetso says: low priority, probably post-4.0 stuff - they're already using icons that are not too far off) || No ||
|-----
|| kdepim || akregator || actions/feed-fetch-all || The action to fetch all newsfeeds (RSS, Atom, ...). [jpetso says: low priority, probably post-4.0 stuff - they're already using icons that are not too far off) || No ||
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kfourinline || kfourinline || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || status/network-connecting || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || apps/im-aim || Icon for the AIM instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-icq || Icon for the ICQ instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-jabber || Icon for the XMPP/Jabber instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-msn || Icon for the MSN instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-yahoo || Icon for the Yahoo! instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || more protocol icons [jpetso: no time for retrieving the whole list right now] || Icon for the [blah blah blah] instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/preferences-desktop-user-privacy || Configuring privacy settings || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-plugin-text-effect-kopete || Configuring text formatting special effects || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-autocorrection || Configuring text autocorrect rules || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-highlighting || Configuring text highlighting - icon exists but only in a low resolution || No || davigno
|-----
|| kdenetwork || kopete || status/kopete-dock-flashing || icon flashed in system tray when new messages are received || No || davigno
|-----
|| kdesdk || kapptemplate || app icon || generates KDE 4 templates to start programming || No ||
|-----
|| kdeutils || kjots || actions/insert-horizontal-rule || icon for inserting a horizontal rule line (for the HTML <hr> tag) such as [http://www.yu.edu/cms/uploadedImages/MIS_ANS/Academic_Computing/ANGEL/clip_image013.jpg this] ||No ||
|-----
|| kdebase || plasma || plasma's toolbox || Toolbox icon to replace the wrench icon. The toolbox (on the top right of the desktop, remember all the screenshots) will allow users to zoom in and out of the desktop, add widgets, configure the desktop, lock the desktop, run commands, etc. From what I understand it's a replacement of the right click menu. Several plasma developers suggested a 2D palette similar to plasma's techbase icon. ~Craig || No ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || apps/amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No ||
|-----
|| Amarok || status/media-track-repeat || An icon for the "repeat the current track" state. || No ||
|-----
|| KPlayer, Amarok || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer, Amarok || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| Kind of... copied the "dice-roll" icon to that location ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer, Dragon Player || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer, Dragon Player || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|-----
|| ktorrent || start-all and stop-all || For starting and stopping torrents we want to use media-playback-start and media-playback-stop, so we would like some matching icons to start and stop all torrents. || No ||
|-----
|| ktorrent || apps/preferences-system-network-ip-filter-ktorrent || Icon for KTorrent's IP Filter plugin. This is a blocklist for bad peers. || No ||
|-----
|| ktorrent || apps/preferences-plugin-scan-folder-ktorrent || Icon for KTorrent's folder scanner plugin. This plugin monitors directories for torrent files, and when a new one is detected, it is loaded into ktorrent. || No ||
|-----
|| ktorrent || apps/preferences-system-network-upnp-ktorrent || Icon for KTorrent's UPnP plugin. || No ||
|-----
|| ktorrent || apps/preferences-system-network-discovery || Icon for KTorrent's zeroconf (DNSSD) plugin, also used by the "Network Discovery" page in the System Settings (which makes for the slightly different icon name). || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

= List of missing icons with screenshot =

List of missing icons from applications with related screenshot:

http://techbase.kde.org/index.php?title=Projects/Oxygen/KDE4_Missing_Icons

Projects/Oxygen/Missing Icons

2007-12-22T18:23:07Z

Djmdave: /* General purpose icons */ view-sort-* done

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || In progress (See discussion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || In progress (will be copyied from the cursor theme) || ruphy
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || Done || davigno
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || Done || davigno
|-----
|| mimetypes/application-x-chm || Icon for *.chm (application/x-chm). || No ||
|-----
|| actions/help-hint || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail [jpetso says: I think it would be appropriate to have the same metaphor for this and the games-hint icon (which should be named help-hint-game anyways)] || No || davigno
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || Done (copied from actions/document-encrypt) ||
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || Done (copied from actions/document-decrypt) ||
|-----
|| apps/preferences-plugin || icon to show that there are plugins to enable, for example in a configuration dialog ||No || davigno
|-----
|| actions/edit-select-all || An icon for the "select all" action. Used in Parley and Ark, at least. Also specified in the naming spec, so... we should really have that one. || Done || davigno
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/view-sort-descending || An icon for sorting lists in descending order (for example, from A-Z, 1-100, etc.). Used in KAddressBook for the "Show Jump Bar", but apart from that it's also specified in the naming spec. So, rather important. || Yes || dmiller
|-----
|| actions/view-sort-ascending || An icon for sorting lists in ascending order (for example, from Z-A, 100-1, etc.). Not currently used as far as I know, but should be easy to do once the corresponding view-sort-descending icon has been drawn. Also specified in the naming spec. || Yes || dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| media-optical-video || icon for DVDs and video CDs, from [http://websvn.kde.org/trunk/KDE/kdelibs/solid/solid/backends/hal/haldevice.cpp?view=markup HalDevice::icon] ||No ||
|-----
|| mimetypes/application-rtf mimetypes/text-rtf || icon for rtf documents || Done (copied from text-enriched) || jpetso
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || actions/edit-undo-close-tab || konqueror undo closed tab [jpetso says: low priority, has a fallback to edit-undo] || No ||
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kickoff || ? || Shutdown (Turn off the computer) || No ||
|-----
|| kdebase || kickoff || ? || Restart (restart the computer) || No ||
|-----
|| kdebase || kickoff || ? || Hibernate || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite || actions/view-top-bottom || A "split vertically" action, similar to view-left-right. || Done. || jpetso
|-----
|| kdebase || kwrite || actions/window-duplicate || An icon to duplicate the current window so that the new window contains the same contents as the current one. Probably keep it visually similar to the "tab-duplicate" icon. || No ||
|-----
|| kdebase || kwrite|| apps/preferences-plugin-insert-file-ktexteditor || KWrite insert file plugin || I think it's appropriate for KWrite to use the "document-import" icon for this purpose, so, "Done." || jpetso
|-----
|| kdebase || kwrite || apps/preferences-plugin-word-completion-ktexteditor || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase || drkonqi || apps/drkonqi || icon for the kde crash manager ||No ||
|-----
|| kdenetwork || kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| kdegraphics || okular || table-of-contents-ltr / table-of-contents-rtl || An icon (in both LtR and RtL versions) representing the table of contents. To be used for indicating the "Contents" tab in the okular sidebar. || No ||
|-----
|| koffice ||koffice apps|| (various) See http://wiki.koffice.org/index.php?title=Icons ||various||No ||
|-----
|| koffice ||kthesaurus apps|| {{bug|49983}} || application icon ||No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || Done || jpetso
|-----
|| kdepim || kmail || actions/mail-mark-junk || Action to mark one or more mails as spam (= junk). [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-important || Action to mark one or more already viewed mails as important, can be found by right-clicking a mail message in KMail [jpetso says: high priority, also required by the icon naming spec] || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-unread || Action to mark one or more already viewed mails as unread, can be found by right-clicking a mail message in KMail [jpetso says: high priority, also required by the icon naming spec] || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-new || Action to mark one or more already viewed mails as new, can be found by right-clicking a mail message in KMail || No ||
|-----
|| kdepim || kmail || actions/mail-mark-task || Action to mark one or more mails as to-do ("Mark Message as Action Item"), can be found by right-clicking a mail message in KMail || No ||
|-----
|| kdepim || kmail || places/mail-sent || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || places/mail-inbox || Icon for folder where received mails are stored by default, as found on the left pane in KMail. || Yes || dmiller
|-----
|| kdepim || kmail || places/mail-outbox || Icon for folder where queued mails (waiting to be sent) are stored, as found on the left pane in KMail. || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-message-new-list || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". [jpetso says: low priority, mail-message-new already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-send ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || Done, use "mail-send-via" for this (which falls back to the existing "mail-send"). jpetso says: I can't think of *any* reason that would warrant a different icon than "mail-send" for this action. If there is a compelling case for a seperate icon, please state it here and rename the icon to mail-send-via. ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/appointment-new || The icon for the "New Event" action. Very important, and even in the icon naming spec. || No ||
|-----
|| kdepim || korganizer || actions/task-new || The icon for the "New Todo" action. || No ||
|-----
|| kdepim || korganizer || actions/journal-new || The icon for the "New Journal" action. I guess view-pim-journal overlayed with the plus icon should do. || No ||
|-----
|| kdepim || korganizer || actions/address-book-open || An icon for viewing, opening or selecting from an address book. Also used somewhere else (KAlarm, I believe), and combined with a plus icon it would be possible to get the specified address-book-new icon. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || An icon representing the new timespent view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || An icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-pim-journal || An icon representing KOrganizer's journal view. || Done ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || An icon representing free/busy time in a calendar. || No ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || No ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || No ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || No ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || No ||
|-----
|| kdepim || kitchensync || actions/sync-start || The action to initiate a synchronization between to devices. || No ||
|-----
|| kdesupport || strigi || apps/strigi || The strigi app icon. It should be an owl.|| Done. However, it's a flashlight instead of an owl. (A very pretty flashlight too :) [[User:Djmdave|Djmdave]] 17:07, 12 November 2007 (CET)) || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kfourinline || kfourinline || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || status/network-connecting || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || status/user-online || Icon representing an IM contact in an online state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the online icon, we might standardize on simple green circle which Pidgin and Adium are using. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-away || Icon representing an IM contact in an away state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the away icon, the Kopete developers would prefer a 1/4 dark clock. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-away-extended || Icon representing an IM contact in an extended away state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the extended away icon, the Kopete developers would prefer a 3/4 dark clock. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-busy || Icon representing an IM contact in a busy state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the offline icon, the Kopete icons would prefer a "one way" sign... in fact, the one inside printer-error would probably be perfect for this purpose. Only covering the whole canvas in the smaller versions probably, but we should use that one. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-offline || Icon representing the user in an unknown state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the unknown state icon, there's no preference for a specific look, but should probably be gray. Pidgin uses a gray "X" icon very similar to our own "window-close". || Done || davigno
|-----
|| kdenetwork || kopete || apps/im-aim || Icon for the AIM instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-icq || Icon for the ICQ instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-jabber || Icon for the XMPP/Jabber instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-msn || Icon for the MSN instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-yahoo || Icon for the Yahoo! instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || more protocol icons [jpetso: no time for retrieving the whole list right now] || Icon for the [blah blah blah] instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/preferences-desktop-user-privacy || Configuring privacy settings || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-plugin-text-effect-kopete || Configuring text formatting special effects || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-autocorrection || Configuring text autocorrect rules || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-highlighting || Configuring text highlighting - icon exists but only in a low resolution || No || davigno
|-----
|| kdenetwork || kopete || status/kopete-dock-flashing || icon flashed in system tray when new messages are received || No || davigno
|-----
|| kdenetwork || kopete || actions/view-statistics || A general icons for a statistics view, used in Kopete for the statistics plugin. KTorrent also has a (download) statistics plugin that would use such an icon, at least it does in its 3.x version. || Done || pinheiro
|-----
|| kdeutils || kwalletmanager || status/wallet-open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || status/wallet-closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || apps/kwalletmanager || kwalletmanager application icon || Done ||
|-----
|| kdesdk || kapptemplate || app icon || generates KDE 4 templates to start programming || No ||
|-----
|| kdewebdev? || ??? (added by [Steveire] to "General purpose icons") || actions/insert-horizontal-rule || icon for inserting a horizontal rule line (for the HTML <hr> tag) such as [http://www.yu.edu/cms/uploadedImages/MIS_ANS/Academic_Computing/ANGEL/clip_image013.jpg this] ||No ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || apps/amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No ||
|-----
|| Amarok || status/media-track-repeat || An icon for the "repeat the current track" state. || No ||
|-----
|| KPlayer, Amarok || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer, Amarok || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| Kind of... copied the "dice-roll" icon to that location ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer, Dragon Player || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer, Dragon Player || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|-----
|| ktorrent || start-all and stop-all || For starting and stopping torrents we want to use media-playback-start and media-playback-stop, so we would like some matching icons to start and stop all torrents. || No ||
|-----
|| ktorrent || apps/preferences-system-network-ip-filter-ktorrent || Icon for KTorrent's IP Filter plugin. This is a blocklist for bad peers. || No ||
|-----
|| ktorrent || apps/preferences-plugin-scan-folder-ktorrent || Icon for KTorrent's folder scanner plugin. This plugin monitors directories for torrent files, and when a new one is detected, it is loaded into ktorrent. || No ||
|-----
|| ktorrent || apps/preferences-system-network-upnp-ktorrent || Icon for KTorrent's UPnP plugin. || No ||
|-----
|| ktorrent || apps/preferences-system-network-discovery || Icon for KTorrent's zeroconf (DNSSD) plugin, also used by the "Network Discovery" page in the System Settings (which makes for the slightly different icon name). || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

= List of missing icons with screenshot =

List of missing icons from applications with related screenshot:

http://techbase.kde.org/Projects/Oxygen/KDE4_Missing_Icons

Projects/Oxygen/Missing Icons

2007-12-22T17:02:27Z

Djmdave: assigning view-sort-{as/des}cending to me

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || In progress (See discussion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || In progress (will be copyied from the cursor theme) || ruphy
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || Done || davigno
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || Done || davigno
|-----
|| mimetypes/application-x-chm || Icon for *.chm (application/x-chm). || No ||
|-----
|| actions/help-hint || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail [jpetso says: I think it would be appropriate to have the same metaphor for this and the games-hint icon (which should be named help-hint-game anyways)] || No || davigno
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || Done (copied from actions/document-encrypt) ||
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || Done (copied from actions/document-decrypt) ||
|-----
|| apps/preferences-plugin || icon to show that there are plugins to enable, for example in a configuration dialog ||No || davigno
|-----
|| actions/edit-select-all || An icon for the "select all" action. Used in Parley and Ark, at least. Also specified in the naming spec, so... we should really have that one. || Done || davigno
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/view-sort-descending || An icon for sorting lists in descending order (for example, from A-Z, 1-100, etc.). Used in KAddressBook for the "Show Jump Bar", but apart from that it's also specified in the naming spec. So, rather important. || No || dmiller
|-----
|| actions/view-sort-ascending || An icon for sorting lists in ascending order (for example, from Z-A, 100-1, etc.). Not currently used as far as I know, but should be easy to do once the corresponding view-sort-descending icon has been drawn. Also specified in the naming spec. || No || dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| media-optical-video || icon for DVDs and video CDs, from [http://websvn.kde.org/trunk/KDE/kdelibs/solid/solid/backends/hal/haldevice.cpp?view=markup HalDevice::icon] ||No ||
|-----
|| mimetypes/application-rtf mimetypes/text-rtf || icon for rtf documents || Done (copied from text-enriched) || jpetso
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || actions/edit-undo-close-tab || konqueror undo closed tab [jpetso says: low priority, has a fallback to edit-undo] || No ||
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kickoff || ? || Shutdown (Turn off the computer) || No ||
|-----
|| kdebase || kickoff || ? || Restart (restart the computer) || No ||
|-----
|| kdebase || kickoff || ? || Hibernate || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite || actions/view-top-bottom || A "split vertically" action, similar to view-left-right. || Done. || jpetso
|-----
|| kdebase || kwrite || actions/window-duplicate || An icon to duplicate the current window so that the new window contains the same contents as the current one. Probably keep it visually similar to the "tab-duplicate" icon. || No ||
|-----
|| kdebase || kwrite|| apps/preferences-plugin-insert-file-ktexteditor || KWrite insert file plugin || I think it's appropriate for KWrite to use the "document-import" icon for this purpose, so, "Done." || jpetso
|-----
|| kdebase || kwrite || apps/preferences-plugin-word-completion-ktexteditor || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase || drkonqi || apps/drkonqi || icon for the kde crash manager ||No ||
|-----
|| kdenetwork || kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| kdegraphics || okular || table-of-contents-ltr / table-of-contents-rtl || An icon (in both LtR and RtL versions) representing the table of contents. To be used for indicating the "Contents" tab in the okular sidebar. || No ||
|-----
|| koffice ||koffice apps|| (various) See http://wiki.koffice.org/index.php?title=Icons ||various||No ||
|-----
|| koffice ||kthesaurus apps|| {{bug|49983}} || application icon ||No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || Done || jpetso
|-----
|| kdepim || kmail || actions/mail-mark-junk || Action to mark one or more mails as spam (= junk). [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-important || Action to mark one or more already viewed mails as important, can be found by right-clicking a mail message in KMail [jpetso says: high priority, also required by the icon naming spec] || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-unread || Action to mark one or more already viewed mails as unread, can be found by right-clicking a mail message in KMail [jpetso says: high priority, also required by the icon naming spec] || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-new || Action to mark one or more already viewed mails as new, can be found by right-clicking a mail message in KMail || No ||
|-----
|| kdepim || kmail || actions/mail-mark-task || Action to mark one or more mails as to-do ("Mark Message as Action Item"), can be found by right-clicking a mail message in KMail || No ||
|-----
|| kdepim || kmail || places/mail-sent || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || places/mail-inbox || Icon for folder where received mails are stored by default, as found on the left pane in KMail. || Yes || dmiller
|-----
|| kdepim || kmail || places/mail-outbox || Icon for folder where queued mails (waiting to be sent) are stored, as found on the left pane in KMail. || Yes || dmiller
|-----
|| kdepim || kmail || actions/mail-message-new-list || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". [jpetso says: low priority, mail-message-new already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-send ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || Done, use "mail-send-via" for this (which falls back to the existing "mail-send"). jpetso says: I can't think of *any* reason that would warrant a different icon than "mail-send" for this action. If there is a compelling case for a seperate icon, please state it here and rename the icon to mail-send-via. ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/appointment-new || The icon for the "New Event" action. Very important, and even in the icon naming spec. || No ||
|-----
|| kdepim || korganizer || actions/task-new || The icon for the "New Todo" action. || No ||
|-----
|| kdepim || korganizer || actions/journal-new || The icon for the "New Journal" action. I guess view-pim-journal overlayed with the plus icon should do. || No ||
|-----
|| kdepim || korganizer || actions/address-book-open || An icon for viewing, opening or selecting from an address book. Also used somewhere else (KAlarm, I believe), and combined with a plus icon it would be possible to get the specified address-book-new icon. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || An icon representing the new timespent view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || An icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-pim-journal || An icon representing KOrganizer's journal view. || Done ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || An icon representing free/busy time in a calendar. || No ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || No ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || No ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || No ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || No ||
|-----
|| kdepim || kitchensync || actions/sync-start || The action to initiate a synchronization between to devices. || No ||
|-----
|| kdesupport || strigi || apps/strigi || The strigi app icon. It should be an owl.|| Done. However, it's a flashlight instead of an owl. (A very pretty flashlight too :) [[User:Djmdave|Djmdave]] 17:07, 12 November 2007 (CET)) || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kfourinline || kfourinline || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || status/network-connecting || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || status/user-online || Icon representing an IM contact in an online state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the online icon, we might standardize on simple green circle which Pidgin and Adium are using. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-away || Icon representing an IM contact in an away state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the away icon, the Kopete developers would prefer a 1/4 dark clock. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-away-extended || Icon representing an IM contact in an extended away state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the extended away icon, the Kopete developers would prefer a 3/4 dark clock. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-busy || Icon representing an IM contact in a busy state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the offline icon, the Kopete icons would prefer a "one way" sign... in fact, the one inside printer-error would probably be perfect for this purpose. Only covering the whole canvas in the smaller versions probably, but we should use that one. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-offline || Icon representing the user in an unknown state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the unknown state icon, there's no preference for a specific look, but should probably be gray. Pidgin uses a gray "X" icon very similar to our own "window-close". || Done || davigno
|-----
|| kdenetwork || kopete || apps/im-aim || Icon for the AIM instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-icq || Icon for the ICQ instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-jabber || Icon for the XMPP/Jabber instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-msn || Icon for the MSN instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-yahoo || Icon for the Yahoo! instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || more protocol icons [jpetso: no time for retrieving the whole list right now] || Icon for the [blah blah blah] instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/preferences-desktop-user-privacy || Configuring privacy settings || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-plugin-text-effect-kopete || Configuring text formatting special effects || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-autocorrection || Configuring text autocorrect rules || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-highlighting || Configuring text highlighting - icon exists but only in a low resolution || No || davigno
|-----
|| kdenetwork || kopete || status/kopete-dock-flashing || icon flashed in system tray when new messages are received || No || davigno
|-----
|| kdenetwork || kopete || actions/view-statistics || A general icons for a statistics view, used in Kopete for the statistics plugin. KTorrent also has a (download) statistics plugin that would use such an icon, at least it does in its 3.x version. || Done || pinheiro
|-----
|| kdeutils || kwalletmanager || status/wallet-open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || status/wallet-closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || apps/kwalletmanager || kwalletmanager application icon || Done ||
|-----
|| kdesdk || kapptemplate || app icon || generates KDE 4 templates to start programming || No ||
|-----
|| kdewebdev? || ??? (added by [Steveire] to "General purpose icons") || actions/insert-horizontal-rule || icon for inserting a horizontal rule line (for the HTML <hr> tag) such as [http://www.yu.edu/cms/uploadedImages/MIS_ANS/Academic_Computing/ANGEL/clip_image013.jpg this] ||No ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || apps/amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No ||
|-----
|| Amarok || status/media-track-repeat || An icon for the "repeat the current track" state. || No ||
|-----
|| KPlayer, Amarok || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer, Amarok || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| Kind of... copied the "dice-roll" icon to that location ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer, Dragon Player || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer, Dragon Player || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|-----
|| ktorrent || start-all and stop-all || For starting and stopping torrents we want to use media-playback-start and media-playback-stop, so we would like some matching icons to start and stop all torrents. || No ||
|-----
|| ktorrent || apps/preferences-system-network-ip-filter-ktorrent || Icon for KTorrent's IP Filter plugin. This is a blocklist for bad peers. || No ||
|-----
|| ktorrent || apps/preferences-plugin-scan-folder-ktorrent || Icon for KTorrent's folder scanner plugin. This plugin monitors directories for torrent files, and when a new one is detected, it is loaded into ktorrent. || No ||
|-----
|| ktorrent || apps/preferences-system-network-upnp-ktorrent || Icon for KTorrent's UPnP plugin. || No ||
|-----
|| ktorrent || apps/preferences-system-network-discovery || Icon for KTorrent's zeroconf (DNSSD) plugin, also used by the "Network Discovery" page in the System Settings (which makes for the slightly different icon name). || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

= List of missing icons with screenshot =

List of missing icons from applications with related screenshot:

http://techbase.kde.org/Projects/Oxygen/KDE4_Missing_Icons

Projects/Oxygen/Missing Icons

2007-12-13T18:38:58Z

Djmdave: /* KDE main modules */ assigning some kmail actions to me

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || In progress (See discussion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || In progress (will be copyied from the cursor theme) || ruphy
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || Done || davigno
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || Done || davigno
|-----
|| actions/help-hint || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail [jpetso says: I think it would be appropriate to have the same metaphor for this and the games-hint icon (which should be named help-hint-game anyways)] || No || davigno
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || Done (copied from actions/document-encrypt) ||
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || Done (copied from actions/document-decrypt) ||
|-----
|| apps/preferences-plugin || icon to show that there are plugins to enable, for example in a configuration dialog ||No || davigno
|-----
|| actions/edit-select-all || An icon for the "select all" action. Used in Parley and Ark, at least. Also specified in the naming spec, so... we should really have that one. || No ||
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/view-sort-descending || An icon for sorting lists in descending order (for example, from A-Z, 1-100, etc.). Used in KAddressBook for the "Show Jump Bar", but apart from that it's also specified in the naming spec. So, rather important. || No ||
|-----
|| actions/view-sort-ascending || An icon for sorting lists in ascending order (for example, from Z-A, 100-1, etc.). Not currently used as far as I know, but should be easy to do once the corresponding view-sort-descending icon has been drawn. Also specified in the naming spec. || No ||
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| media-optical-video || icon for DVDs and video CDs, from [http://websvn.kde.org/trunk/KDE/kdelibs/solid/solid/backends/hal/haldevice.cpp?view=markup HalDevice::icon] ||No ||
|-----
|| mimetypes/application-rtf mimetypes/text-rtf || icon for rtf documents ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || actions/edit-undo-close-tab || konqueror undo closed tab [jpetso says: low priority, has a fallback to edit-undo] || No ||
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite || actions/view-top-bottom || A "split vertically" action, similar to view-left-right. || Done. || jpetso
|-----
|| kdebase || kwrite || actions/window-duplicate || An icon to duplicate the current window so that the new window contains the same contents as the current one. Probably keep it visually similar to the "tab-duplicate" icon. || No ||
|-----
|| kdebase || kwrite|| apps/preferences-plugin-insert-file-ktexteditor || KWrite insert file plugin || I think it's appropriate for KWrite to use the "document-import" icon for this purpose, so, "Done." || jpetso
|-----
|| kdebase || kwrite || apps/preferences-plugin-word-completion-ktexteditor || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || Done || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || In progress || Pinheiro
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase || drkonqi || apps/drkonqi || icon for the kde crash manager ||No ||
|-----
|| kdenetwork || kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| kdegraphics || okular || table-of-contents-ltr / table-of-contents-rtl || An icon (in both LtR and RtL versions) representing the table of contents. To be used for indicating the "Contents" tab in the okular sidebar. || No ||
|-----
|| koffice ||koffice apps|| (various) See http://wiki.koffice.org/index.php?title=Icons ||various||No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || Done || jpetso
|-----
|| kdepim || kmail || actions/mail-mark-junk || Action to mark one or more mails as spam (= junk). [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-important || Action to mark one or more already viewed mails as important, can be found by right-clicking a mail message in KMail [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-unread || Action to mark one or more already viewed mails as unread, can be found by right-clicking a mail message in KMail [jpetso says: high priority, also required by the icon naming spec] || No || dmiller
|-----
|| kdepim || kmail || actions/mail-mark-new || Action to mark one or more already viewed mails as new, can be found by right-clicking a mail message in KMail || No ||
|-----
|| kdepim || kmail || actions/mail-mark-task || Action to mark one or more mails as to-do ("Mark Message as Action Item"), can be found by right-clicking a mail message in KMail || No ||
|-----
|| kdepim || kmail || places/mail-sent || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || places/mail-inbox || Icon for folder where received mails are stored by default, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || places/mail-outbox || Icon for folder where queued mails (waiting to be sent) are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || actions/mail-message-new-list || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". [jpetso says: low priority, mail-message-new already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-send ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || Done, use "mail-send-via" for this (which falls back to the existing "mail-send"). jpetso says: I can't think of *any* reason that would warrant a different icon than "mail-send" for this action. If there is a compelling case for a seperate icon, please state it here and rename the icon to mail-send-via. ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/appointment-new || The icon for the "New Event" action. Very important, and even in the icon naming spec. || No ||
|-----
|| kdepim || korganizer || actions/task-new || The icon for the "New Todo" action. || No ||
|-----
|| kdepim || korganizer || actions/journal-new || The icon for the "New Journal" action. I guess view-pim-journal overlayed with the plus icon should do. || No ||
|-----
|| kdepim || korganizer || actions/address-book-open || An icon for viewing, opening or selecting from an address book. Also used somewhere else (KAlarm, I believe), and combined with a plus icon it would be possible to get the specified address-book-new icon. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || An icon representing the new timespent view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || An icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-pim-journal || An icon representing KOrganizer's journal view. || Done ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || An icon representing free/busy time in a calendar. || No ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || No ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || No ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || No ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || No ||
|-----
|| kdepim || kitchensync || actions/sync-start || The action to initiate a synchronization between to devices. || No ||
|-----
|| kdesupport || strigi || apps/strigi || The strigi app icon. It should be an owl.|| Done. However, it's a flashlight instead of an owl. (A very pretty flashlight too :) [[User:Djmdave|Djmdave]] 17:07, 12 November 2007 (CET)) || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kwin4 || kwin4 || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || status/network-connecting || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || status/user-online || Icon representing an IM contact in an online state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the online icon, we might standardize on simple green circle which Pidgin and Adium are using. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-away || Icon representing an IM contact in an away state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the away icon, the Kopete developers would prefer a 1/4 dark clock. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-away-extended || Icon representing an IM contact in an extended away state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the extended away icon, the Kopete developers would prefer a 3/4 dark clock. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-busy || Icon representing an IM contact in a busy state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the offline icon, the Kopete icons would prefer a "one way" sign... in fact, the one inside printer-error would probably be perfect for this purpose. Only covering the whole canvas in the smaller versions probably, but we should use that one. || Done || davigno
|-----
|| kdenetwork || kopete || status/user-offline || Icon representing the user in an unknown state. Used full size in the contact list, and as overlay for user and protocol icons. As every contact gets one of those status icons and overlays are pretty tiny, this should be rather simple - for the unknown state icon, there's no preference for a specific look, but should probably be gray. Pidgin uses a gray "X" icon very similar to our own "window-close". || Done || davigno
|-----
|| kdenetwork || kopete || apps/im-aim || Icon for the AIM instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-icq || Icon for the ICQ instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-jabber || Icon for the XMPP/Jabber instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-msn || Icon for the MSN instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/im-yahoo || Icon for the Yahoo! instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || more protocol icons [jpetso: no time for retrieving the whole list right now] || Icon for the [blah blah blah] instant messaging protocol || No || johann_ol
|-----
|| kdenetwork || kopete || apps/preferences-desktop-user-privacy || Configuring privacy settings || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-plugin-text-effect-kopete || Configuring text formatting special effects || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-autocorrection || Configuring text autocorrect rules || No || davigno
|-----
|| kdenetwork || kopete || apps/preferences-text-highlighting || Configuring text highlighting - icon exists but only in a low resolution || No || davigno
|-----
|| kdenetwork || kopete || status/kopete-dock-flashing || icon flashed in system tray when new messages are received || No || davigno
|-----
|| kdenetwork || kopete || actions/view-statistics || A general icons for a statistics view, used in Kopete for the statistics plugin. KTorrent also has a (download) statistics plugin that would use such an icon, at least it does in its 3.x version. || Done || pinheiro
|-----
|| kdeutils || kwalletmanager || status/wallet-open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || status/wallet-closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || apps/kwalletmanager || kwalletmanager application icon || Done ||
|-----
|| kdesdk || kapptemplate || app icon || generates KDE 4 templates to start programming || No ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || apps/amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No ||
|-----
|| Amarok || status/media-track-repeat || An icon for the "repeat the current track" state. || No ||
|-----
|| KPlayer, Amarok || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer, Amarok || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| Kind of... copied the "dice-roll" icon to that location ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|-----
|| ktorrent || start-all and stop-all || For starting and stopping torrents we want to use media-playback-start and media-playback-stop, so we would like some matching icons to start and stop all torrents. || No ||
|-----
|| ktorrent || apps/preferences-system-network-ip-filter-ktorrent || Icon for KTorrent's IP Filter plugin. This is a blocklist for bad peers. || No ||
|-----
|| ktorrent || apps/preferences-plugin-scan-folder-ktorrent || Icon for KTorrent's folder scanner plugin. This plugin monitors directories for torrent files, and when a new one is detected, it is loaded into ktorrent. || No ||
|-----
|| ktorrent || apps/preferences-system-network-upnp-ktorrent || Icon for KTorrent's UPnP plugin. || No ||
|-----
|| ktorrent || apps/preferences-system-network-discovery || Icon for KTorrent's zeroconf (DNSSD) plugin, also used by the "Network Discovery" page in the System Settings (which makes for the slightly different icon name). || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

Projects/Oxygen/TodoList

2007-11-12T22:26:12Z

Djmdave: todo list

Make this page your home page!! :P
=4.0=
==Actions==
*remove shadows from all icons (the shadows giving the 'shelf' perspective)
==Animations==
*the progress animation
**should not have any kde specific branding? [[User:Djmdave|Djmdave]] 23:26, 12 November 2007 (CET)
==Apps==
*for priority apps that need drawing see [[../namingSpec/apps#To_do_for_Oxygen]]
*i want to ensure all apps look good att 16px as they will be used in the window decorations [[User:Djmdave|Djmdave]] 23:26, 12 November 2007 (CET)
==Categories==
*a couple of icons that are needed [[../namingSpec/categories#To_do_for_Oxygen]]
*i want to make sure that 32x32 look nice (i was concentrating on 22px but kickoff uses 32px now. hopefully the classic menu will use 22px :)) [[User:Djmdave|Djmdave]] 23:26, 12 November 2007 (CET)
==Devices==
*see [[../namingSpec/devices#To_do_for_Oxygen]]. just a video camera and zip disk icon needed
==Emblems==
*see [[../namingSpec/emblems#To_do_for_Oxygen]]
**can dolphin do emblems for folders etc? if not then are these not critical? [[User:Djmdave|Djmdave]] 23:26, 12 November 2007 (CET)
==Emotes==
*see [[../namingSpec/emotes#To_do_for_Oxygen]] only 3 to do (easy!)
==Intl==
*wtf?!
==Mimetypes==
*[[../namingSpec/mimetypes#To_do_for_Oxygen]]
**template icon and a couple of inode icons needed
***template is practically done in the office-* mimes? [[User:Djmdave|Djmdave]] 23:26, 12 November 2007 (CET)
==Places==
*[[../namingSpec/places#To_do_for_Oxygen]]
**just need wallpaper for the basis of the desktop icon? [[User:Djmdave|Djmdave]] 23:26, 12 November 2007 (CET)
==Status==
*[[../namingSpec/status#To_do_for_Oxygen]] <- quite a lot needed

Projects/Oxygen/Missing Icons

2007-11-12T21:42:33Z

Djmdave: icons that aren't missing shouldn't be here :)

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || Done (See disscusion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || No ||
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || No ||
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || No ||
|-----
|| idea || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail || No ||
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| general-plugin || icon to show that there are plugins to enable, for example in a configuration dialog || ||
|-----
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite|| insert_file || KWrite insert file plugin || No ||
|-----
|| kdebase || kwrite || word_completion || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || No ||
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || No ||
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase
|| kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| koffice ||koffice apps|| (various) See http://wiki.koffice.org/index.php?title=Icons ||various||No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || No ||
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || No ||
|-----
|| kdepim || kmail || places/folder-sent-mail || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail_post_to || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". || No ||
|-----
|| kdepim || kmail || mail_send_via ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || Doesn't exist yet. an icon representing the new timespent view. || No || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || Doesn't exist yet. an icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-journal || Doesn't exist yet. an icon representing KOrganizer's journal view. || New ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || Doesn't exist yet. an icon representing freebusy time in a calendar || New ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || New ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || New ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || New ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || New ||
|-----
|| kdesupport || strigi || strigi || Doesn't exist yet. It should be an owl.|| Done. However, it's a flashlight instead of an owl. (A very pretty flashlight too :) [[User:Djmdave|Djmdave]] 17:07, 12 November 2007 (CET)) || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kwin4 || kwin4 || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || connect-creating || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || kopeteavailable || Icon representing the user in an online state. Used to set status to online || No ||
|-----
|| kdenetwork || kopete || kopeteaway || Icon representing the local user in an away state. Used to set status to away. NB for this and the following kopetebusy there are overlay icons (small clock faces etc) in kdenetwork/kopete/icons that are used to generate contact status icons at runtime. It would be good if these icons were consistent with the overlay icons || No ||
|-----
|| kdenetwork || kopete || kopetebusy || Icon representing the local user in an away state. Used to set status to busy || No ||
|-----
|| kdenetwork || kopete || status/user-away || Icon representing an IM contact in an away state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || status/user-online || Icon representing an IM contact in an online state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || status/user-offline || Icon representing an IM contact in an offline state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_unknown || Icon representing the user in an unknown state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || kopete_privacy || Configuring privacy settings || No ||
|-----
|| kdenetwork || kopete || kopete_texteffect || Configuring text formatting special effects || No ||
|-----
|| kdenetwork || kopete || kopete_autoreplace || Configuring text autocorrect rules || No ||
|-----
|| kdenetwork || kopete || highlight || Configuring text highlighting - icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || urlpicpreview || icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || newmsg || icon flashed in system tray when new messages are received || No ||
|-----
|| kdeutils || kwalletmanager || status/wallet-open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || status/wallet-closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || apps/kwalletmanager || kwalletmanager application icon || Done ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No
||
|-----
|| KPlayer || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| No ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

Projects/Oxygen/Missing Icons

2007-11-12T21:36:38Z

Djmdave: /* KDE main modules */ kontact modules added

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || Done (See disscusion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || No ||
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || No ||
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || No ||
|-----
|| idea || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail || No ||
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| general-plugin || icon to show that there are plugins to enable, for example in a configuration dialog || ||
|-----
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite|| insert_file || KWrite insert file plugin || No ||
|-----
|| kdebase || kwrite || word_completion || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || No ||
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || No ||
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase
|| kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| koffice ||koffice apps|| (various) See http://wiki.koffice.org/index.php?title=Icons ||various||No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kontact || view-pim-mail || switch to email in kontact || No ||
|-----
|| kdepim || kontact || view-pim-contacts || switch to contacts in kontact || No ||
|-----
|| kdepim || kontact || view-pim-calendar || switch to calendar in kontact || No ||
|-----
|| kdepim || kontact || view-pim-journal || switch to journal in kontact || No ||
|-----
|| kdepim || kontact || view-pim-notes || switch to notes in kontact || No ||
|-----
|| kdepim || kontact || view-pim-tasks || switch to tasks in kontact || No ||
|-----
|| kdepim || kontact || view-pim-summary || switch to summary view in kontact || No ||
|-----
|| kdepim || kontact || view-pim-newsfeeds || switch to rss/news reader in kontact || No ||
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || No ||
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || No ||
|-----
|| kdepim || kmail || places/folder-sent-mail || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail_post_to || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". || No ||
|-----
|| kdepim || kmail || mail_send_via ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || Doesn't exist yet. an icon representing the new timespent view. || No || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || Doesn't exist yet. an icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-journal || Doesn't exist yet. an icon representing KOrganizer's journal view. || New ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || Doesn't exist yet. an icon representing freebusy time in a calendar || New ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || New ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || New ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || New ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || New ||
|-----
|| kdesupport || strigi || strigi || Doesn't exist yet. It should be an owl.|| Done. However, it's a flashlight instead of an owl. (A very pretty flashlight too :) [[User:Djmdave|Djmdave]] 17:07, 12 November 2007 (CET)) || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kwin4 || kwin4 || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || connect-creating || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || kopeteavailable || Icon representing the user in an online state. Used to set status to online || No ||
|-----
|| kdenetwork || kopete || kopeteaway || Icon representing the local user in an away state. Used to set status to away. NB for this and the following kopetebusy there are overlay icons (small clock faces etc) in kdenetwork/kopete/icons that are used to generate contact status icons at runtime. It would be good if these icons were consistent with the overlay icons || No ||
|-----
|| kdenetwork || kopete || kopetebusy || Icon representing the local user in an away state. Used to set status to busy || No ||
|-----
|| kdenetwork || kopete || status/user-away || Icon representing an IM contact in an away state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || status/user-online || Icon representing an IM contact in an online state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || status/user-offline || Icon representing an IM contact in an offline state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_unknown || Icon representing the user in an unknown state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || kopete_privacy || Configuring privacy settings || No ||
|-----
|| kdenetwork || kopete || kopete_texteffect || Configuring text formatting special effects || No ||
|-----
|| kdenetwork || kopete || kopete_autoreplace || Configuring text autocorrect rules || No ||
|-----
|| kdenetwork || kopete || highlight || Configuring text highlighting - icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || urlpicpreview || icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || newmsg || icon flashed in system tray when new messages are received || No ||
|-----
|| kdeutils || kwalletmanager || status/wallet-open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || status/wallet-closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || apps/kwalletmanager || kwalletmanager application icon || Done ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No
||
|-----
|| KPlayer || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| No ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

Projects/Oxygen/Missing Icons

2007-11-12T16:20:47Z

Djmdave: /* KDE main modules */ fixed a few layout problems casued by long links (i think)

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || Done (See disscusion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || No ||
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || No ||
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || No ||
|-----
|| idea || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail || No ||
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| general-plugin || icon to show that there are plugins to enable, for example in a configuration dialog || ||
|-----
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite|| insert_file || KWrite insert file plugin || No ||
|-----
|| kdebase || kwrite || word_completion || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || No ||
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || No ||
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase
|| kopete (misc) || (various) || Emoticons for Kopete, See [[../Missing_Emoticons]] || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| koffice ||koffice apps|| (various) See http://wiki.koffice.org/index.php?title=Icons ||various||No ||
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || No ||
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || No ||
|-----
|| kdepim || kmail || places/folder-sent-mail || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail_post_to || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". || No ||
|-----
|| kdepim || kmail || mail_send_via ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || Doesn't exist yet. an icon representing the new timespent view. || No || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || Doesn't exist yet. an icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-journal || Doesn't exist yet. an icon representing KOrganizer's journal view. || New ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || Doesn't exist yet. an icon representing freebusy time in a calendar || New ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || New ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || New ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || New ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || New ||
|-----
|| kdesupport || strigi || strigi || Doesn't exist yet. It should be an owl.|| Done. However, it's a flashlight instead of an owl. (A very pretty flashlight too :) [[User:Djmdave|Djmdave]] 17:07, 12 November 2007 (CET)) || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kwin4 || kwin4 || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || connect-creating || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || kopeteavailable || Icon representing the user in an online state. Used to set status to online || No ||
|-----
|| kdenetwork || kopete || kopeteaway || Icon representing the local user in an away state. Used to set status to away. NB for this and the following kopetebusy there are overlay icons (small clock faces etc) in kdenetwork/kopete/icons that are used to generate contact status icons at runtime. It would be good if these icons were consistent with the overlay icons || No ||
|-----
|| kdenetwork || kopete || kopetebusy || Icon representing the local user in an away state. Used to set status to busy || No ||
|-----
|| kdenetwork || kopete || status/user-away || Icon representing an IM contact in an away state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || status/user-online || Icon representing an IM contact in an online state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || status/user-offline || Icon representing an IM contact in an offline state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_unknown || Icon representing the user in an unknown state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || kopete_privacy || Configuring privacy settings || No ||
|-----
|| kdenetwork || kopete || kopete_texteffect || Configuring text formatting special effects || No ||
|-----
|| kdenetwork || kopete || kopete_autoreplace || Configuring text autocorrect rules || No ||
|-----
|| kdenetwork || kopete || highlight || Configuring text highlighting - icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || urlpicpreview || icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || newmsg || icon flashed in system tray when new messages are received || No ||
|-----
|| kdeutils || kwalletmanager || status/wallet-open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || status/wallet-closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || apps/kwalletmanager || kwalletmanager application icon || Done ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No
||
|-----
|| KPlayer || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| No ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

Projects/Oxygen/Missing Icons

2007-11-12T16:07:46Z

Djmdave: /* KDE main modules */ Bille, read message about kopete plugin

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || Done (See disscusion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || No ||
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || No ||
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || No ||
|-----
|| idea || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail || No ||
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| general-plugin || icon to show that there are plugins to enable, for example in a configuration dialog || ||
|-----
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite|| insert_file || KWrite insert file plugin || No ||
|-----
|| kdebase || kwrite || word_completion || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || No ||
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || No ||
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase
|| kopete (misc) || (various) || Emoticons for Kopete, See http://techbase.kde.org/index.php?title=Projects/Oxygen/Missing_Emoticons || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| koffice
|| (all)
|colspan="4"| See http://wiki.koffice.org/index.php?title=Icons
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-row & action/insert-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || No ||
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || No ||
|-----
|| kdepim || kmail || places/folder-sent-mail || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail_post_to || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". || No ||
|-----
|| kdepim || kmail || mail_send_via ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || Doesn't exist yet. an icon representing the new timespent view. || No || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || Doesn't exist yet. an icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-journal || Doesn't exist yet. an icon representing KOrganizer's journal view. || New ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || Doesn't exist yet. an icon representing freebusy time in a calendar || New ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || New ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || New ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || New ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || New ||
|-----
|| kdesupport || strigi || strigi || Doesn't exist yet. It should be an owl.|| Done. However, it's a flashlight instead of an owl. (A very pretty flashlight too :) [[User:Djmdave|Djmdave]] 17:07, 12 November 2007 (CET)) || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kwin4 || kwin4 || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || connect-creating || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || kopeteavailable || Icon representing the user in an online state. Used to set status to online || No ||
|-----
|| kdenetwork || kopete || kopeteaway || Icon representing the local user in an away state. Used to set status to away. NB for this and the following kopetebusy there are overlay icons (small clock faces etc) in kdenetwork/kopete/icons that are used to generate contact status icons at runtime. It would be good if these icons were consistent with the overlay icons || No ||
|-----
|| kdenetwork || kopete || kopetebusy || Icon representing the local user in an away state. Used to set status to busy || No ||
|-----
|| kdenetwork || kopete || status/user-away || Icon representing an IM contact in an away state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || status/user-online || Icon representing an IM contact in an online state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || status/user-offline || Icon representing an IM contact in an offline state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_unknown || Icon representing the user in an unknown state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || kopete_privacy || Configuring privacy settings || No ||
|-----
|| kdenetwork || kopete || kopete_texteffect || Configuring text formatting special effects || No ||
|-----
|| kdenetwork || kopete || kopete_autoreplace || Configuring text autocorrect rules || No ||
|-----
|| kdenetwork || kopete || highlight || Configuring text highlighting - icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || urlpicpreview || icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || newmsg || icon flashed in system tray when new messages are received || No ||
|-----
|| kdeutils || kwalletmanager || status/wallet-open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || status/wallet-closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || apps/kwalletmanager || kwalletmanager application icon || Done ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No
||
|-----
|| KPlayer || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| No ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

Projects/Oxygen/Missing Icons

2007-11-11T16:39:58Z

Djmdave: /* General purpose icons */ format-list-(un)ordered done

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || Done (See disscusion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || No ||
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || No ||
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || No ||
|-----
|| idea || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail || No ||
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| general-plugin || icon to show that there are plugins to enable, for example in a configuration dialog || ||
|-----
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||Done ||dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite|| insert_file || KWrite insert file plugin || No ||
|-----
|| kdebase || kwrite || word_completion || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || No ||
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || No ||
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase
|| kopete (misc) || (various) || Emoticons for Kopete, See http://techbase.kde.org/index.php?title=Projects/Oxygen/Missing_Emoticons || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| koffice
|| (all)
|colspan="4"| See http://wiki.koffice.org/index.php?title=Icons
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-table-row & action/insert-table-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || No ||
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || No ||
|-----
|| kdepim || kmail || places/folder-sent-mail || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail_post_to || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". || No ||
|-----
|| kdepim || kmail || mail_send_via ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || Doesn't exist yet. an icon representing the new timespent view. || No || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || Doesn't exist yet. an icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-journal || Doesn't exist yet. an icon representing KOrganizer's journal view. || New ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || Doesn't exist yet. an icon representing freebusy time in a calendar || New ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || New ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || New ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || New ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || New ||
|-----
|| kdesupport || strigi || strigi || Doesn't exist yet. It should be an owl.|| Done. However, it's a flashlight instead of an owl. || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kwin4 || kwin4 || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || connect-creating || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || kopeteavailable || Icon representing the user in an online state. Used to set status to online || No ||
|-----
|| kdenetwork || kopete || kopeteaway || Icon representing the user in an away state. Used to set status to away. NB for this and the following kopetebusy there are overlay icons (small clock faces etc) in kdenetwork/kopete/icons that are used to generate contact status icons at runtime. It would be good if these icons were consistent with the overlay icons || No ||
|-----
|| kdenetwork || kopete || kopetebusy || Icon representing the user in an away state. Used to set status to busy || No ||
|-----
|| kdenetwork || kopete || metacontact_away || Icon representing an IM contact in an away state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_online || Icon representing an IM contact in an online state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_offline || Icon representing an IM contact in an offline state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_unknown || Icon representing the user in an unknown state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || kopete_plugin || Generic icon for extensions - please no literal 'plug' icon as we use this already for network connections || No There is a generic plugin icon request above. do we really need kopete specific one? [[User:Djmdave|Djmdave]] 16:20, 11 November 2007 (CET) ||
|-----
|| kdenetwork || kopete || kopete_privacy || Configuring privacy settings || No ||
|-----
|| kdenetwork || kopete || kopete_texteffect || Configuring text formatting special effects || No ||
|-----
|| kdenetwork || kopete || kopete_autoreplace || Configuring text autocorrect rules || No ||
|-----
|| kdenetwork || kopete || highlight || Configuring text highlighting - icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || urlpicpreview || icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || newmsg || icon flashed in system tray when new messages are received || No ||
|-----
|| kdeutils || kwalletmanager || wallet_open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || wallet_closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || kwalletmanager || kwalletmanager application icon || Done ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No
||
|-----
|| KPlayer || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| No ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

Projects/Oxygen/Missing Icons

2007-11-11T15:20:55Z

Djmdave: /* KDE main modules */ kopete plugin vs generic plugin comment

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| actions/transform-scale (ArtLibreSet) || an icon for an image resize action. || Done (See disscusion page) || dmiller
|-----
|| actions/transform-move (ArtLibreSet) || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || No ||
|-----
|| mimetypes/application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || No ||
|-----
|| mimetypes/application-x-php || Icon for *.php (application/x-php). || No ||
|-----
|| idea || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail || No ||
|-----
|| status/object-locked (ArtLibreSet) || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| status/object-unlocked (ArtLibreSet) || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| general-plugin || icon to show that there are plugins to enable, for example in a configuration dialog || ||
|-----
|-----
|| actions/format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||No ||dmiller
|-----
|| actions/format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||No ||dmiller
|-----
|| actions/object-flip-horizontal (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|| actions/object-flip-vertical (naming spec) || icon for flipping an image or object in a drawing/graphics program ||No ||
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktop-grid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite|| insert_file || KWrite insert file plugin || No ||
|-----
|| kdebase || kwrite || word_completion || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || No ||
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || No ||
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase
|| kopete (misc) || (various) || Emoticons for Kopete, See http://techbase.kde.org/index.php?title=Projects/Oxygen/Missing_Emoticons || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| koffice
|| (all)
|colspan="4"| See http://wiki.koffice.org/index.php?title=Icons
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-table-row & action/insert-table-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || categories/preferences-other || KMail configuration dialog for miscellaneous configurations || No ||
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || No ||
|-----
|| kdepim || kmail || places/folder-sent-mail || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail_post_to || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". || No ||
|-----
|| kdepim || kmail || mail_send_via ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || Doesn't exist yet. an icon representing the new timespent view. || No || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || Doesn't exist yet. an icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-journal || Doesn't exist yet. an icon representing KOrganizer's journal view. || New ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || Doesn't exist yet. an icon representing freebusy time in a calendar || New ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || New ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || New ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || New ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || New ||
|-----
|| kdesupport || strigi || strigi || Doesn't exist yet. It should be an owl.|| Done. However, it's a flashlight instead of an owl. || Pinheiro
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kwin4 || kwin4 || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || connect-creating || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || kopeteavailable || Icon representing the user in an online state. Used to set status to online || No ||
|-----
|| kdenetwork || kopete || kopeteaway || Icon representing the user in an away state. Used to set status to away. NB for this and the following kopetebusy there are overlay icons (small clock faces etc) in kdenetwork/kopete/icons that are used to generate contact status icons at runtime. It would be good if these icons were consistent with the overlay icons || No ||
|-----
|| kdenetwork || kopete || kopetebusy || Icon representing the user in an away state. Used to set status to busy || No ||
|-----
|| kdenetwork || kopete || metacontact_away || Icon representing an IM contact in an away state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_online || Icon representing an IM contact in an online state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_offline || Icon representing an IM contact in an offline state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_unknown || Icon representing the user in an unknown state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || kopete_plugin || Generic icon for extensions - please no literal 'plug' icon as we use this already for network connections || No There is a generic plugin icon request above. do we really need kopete specific one? [[User:Djmdave|Djmdave]] 16:20, 11 November 2007 (CET) ||
|-----
|| kdenetwork || kopete || kopete_privacy || Configuring privacy settings || No ||
|-----
|| kdenetwork || kopete || kopete_texteffect || Configuring text formatting special effects || No ||
|-----
|| kdenetwork || kopete || kopete_autoreplace || Configuring text autocorrect rules || No ||
|-----
|| kdenetwork || kopete || highlight || Configuring text highlighting - icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || urlpicpreview || icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || newmsg || icon flashed in system tray when new messages are received || No ||
|-----
|| kdeutils || kwalletmanager || wallet_open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || wallet_closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || kwalletmanager || kwalletmanager application icon || Done ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No
||
|-----
|| KPlayer || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| No ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

Projects/Oxygen/Missing Icons

2007-11-10T22:28:03Z

Djmdave: /* General purpose icons */ assigning these to me. i want to finishoff the format-* icons at small sizes anyway

The page will help Oxygen team to track and produce icons that are currently missing in KDE4. Additionally it will help developers to make requests for icons that they need for KDE4 related projects.

= Instructions to fill out the request =

* This page, being a wiki, obviously does not validate your request. Please take care when providing information about the icons. Note that this page is mainly for the team to know where is mostly needed the work, we'll do our best to fullfill your requests for 4.0 but however we can't guarantee that. =)

* When providing icon names please try to make them compatible with the actual naming scheme.

* Please provide clear but short descriptions about the icons, it needs to help the artists in imagining a good metaphore to make your icon. '''This point is extremely important'''. You may obviously also link your description if it's going to be lengthy. This will help us to manage icon requests, and check if there are any possible duplicates. The most descriptive you are, the best it is for us.

* Screenshots are sometimes a better way to easily show the usage of the icon. Provide metaphores when possible this will help the artist to visualize our reqest faster and give a better understanding of the reqest.

* As someone already noted, this is not the right page to complain or make suggestions about existing icon, this is just to know the remaining work.

* Please sort by module/application/priority

= Missing Icons Table =

== General purpose icons ==
For icons like the folder, or the desktop.

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| image-resize || an icon for an image resize action. || Done (See disscusion page) || dmiller
|-----
|| move || move action [[http://websvn.kde.org/branches/KDE/3.5/kdelibs/pics/crystalsvg/cr16-action-move.png?revision=438982&view=markup]] || No ||
|-----
|| application-javascript || Icon for *.js (application/javascript) files just like we have them for e.g. Python and Ruby. || No ||
|-----
|| application-x-php || Icon for *.php (application/x-php). || No ||
|-----
|| idea || KStandardAction for "Tip of the Day", for example seen in the help menu of KMail || No ||
|-----
|| item-locked || icon to show that an item or ui element is locked and will not move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| item-unlocked || icon to show that an item or ui element is unlocked and will move or disappear, such as a toolbar in a fullscreen window || No || Pinheiro
|-----
|| general-plugin || icon to show that there are plugins to enable, for example in a configuration dialog || ||
|-----
|-----
|| format-list-ordered || icon for indicating the creation of an ordered i.e. numbered list. Qt rich-text classes mean this will probably be used more often ||No ||dmiller
|-----
|| format-list-unordered || icon for indicating the creation of an unordered i.e. bulleted list. Qt rich-text classes mean this will probably be used more often ||No ||dmiller
|-----
|}

== KDE main modules ==
For apps in trunk/KDE/

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Module
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| kdebase || konqueror || apps/preferences-desktop-filetype-association || konqueror configuration dialog File Associations || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-adblock || konqueror configuration dialog AdBlock Filters || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-shortcuts || konqueror configuration dialog Web Shortcuts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cache || konqueror configuration dialog Cache || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-system-network-proxy || konqueror configuration dialog Proxy || In progress || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-font || konqueror configuration dialog Fonts || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-stylesheets || konqueror configuration dialog Stylesheets || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-cookies || konqueror configuration dialog Cookies || Done || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-web-browser-identification || konqueror configuration dialog Browser Identification || Done 3/4 || Pinheiro
|-----
|| kdebase || konqueror || apps/preferences-desktop-text-to-speech || Konqueror text-to-speech plugin || Done || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect || Generic effect icon || In progress || Pinheiro
|-----
|| kdebase || kwin|| apps/preferences-desktop-effect || Desktop effects config module || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-boxswitch || Boxswitch (alt-tab) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-desktopgrid || Desktopgrid (desktop switcher) effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-presentwindows || Presentwindows effect (low priority) || No ||
|-----
|| kdebase || kwin|| apps/preferences-system-windows-effect-shadow || Shadow effect (low priority) || No ||
|-----
|| kdebase || kwrite || apps/kwrite || Previously existed, recently removed from SVN. See Misc requests below for details || Still exists (renamed accessories-text-editor)||
|-----
|| kdebase || kwrite|| insert_file || KWrite insert file plugin || No ||
|-----
|| kdebase || kwrite || word_completion || KWrite word completion plugin || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-color || Desktop colour settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-icons || Desktop icon settings configuration module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-theme || Desktop theme selector module || No ||
|-----
|| kdebase || systemsettings || categories/preferences-desktop || Desktop configuration category || No ||
|-----
|| kdebase || systemsettings || apps/preferences-system-network-sharing || Network shares config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-launch-feedback || Launch feedback config module || No ||
|-----
|| kdebase || systemsettings || apps/preferences-desktop-login || KDM/login manager config module || Done - named preferences-system-login [[User:Djmdave|Djmdave]] 14:27, 1 November 2007 (CET) || Dmiller
|-----
|| kdebase
|| kopete (misc) || (various) || Emoticons for Kopete, See http://techbase.kde.org/index.php?title=Projects/Oxygen/Missing_Emoticons || No ||
|-----
|| kdemultimedia || kmix|| kmix icons || KMix icons || No ||
|-----
|| koffice
|| (all)
|colspan="4"| See http://wiki.koffice.org/index.php?title=Icons
|-----
|| kdeedu || kalgebra || apps/kalgebra || Application Icon kdeedu/kalgebra/icons || No ||
|-----
|| kdeedu || kig || apps/kig || Application Icon kdeedu/kig/kig || No ||
|-----
|| kdeedu || parley || apps/parley || Application Icon kdeedu/parley/parley || In Progress || Leeo
|-----
|| kdeedu || parley || action/insert-table-row & action/insert-table-column || Add a new entry in parley || In Progress || Leeo
|-----
|| kdeedu || parley || practice || Start parley's practice || In Progress || Leeo
|-----
|| kdepim || kmail || identity || KMail configuration dialog for managing identities || Done, as places/contact ||
|-----
|| kdepim || kmail || actions/preferences-other || KMail configuration dialog for miscellaneous configurations || Done ||
|-----
|| kdepim || kmail || actions/mail-mark-read || Action to mark all currently unread mails in one folder as read ("Mark All Messages as Read"), can be found in the "Folder" menu of KMail [jpetso says: high priority, also required by the icon naming spec] || No ||
|-----
|| kdepim || kmail || places/folder-sent-mail || Icon for folder where successfully sent mails are stored, as found on the left pane in KMail. || No ||
|-----
|| kdepim || kmail || actions/mail-reply-custom || Reply to the currently selected message with a custom (user-created) template message. Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-reply-all-custom || Reply to the currently selected message with a custom (user-created) template message, and send the message to every addressee (All which are in To, From and CC headers). Found in the "Message->Reply Special" menu entry in KMail. [jpetso says: low priority, mail-reply-all already exists as fallback.] || No ||
|-----
|| kdepim || kmail || actions/mail-forward-custom || Forward the currently selected message, using a custom (user-created) template message. Found in the "Message->Forward" menu entry in KMail. [jpetso says: low priority, mail-forward already exists as fallback.] || No ||
|-----
|| kdepim || kmail || mail_post_to || Creates a new message, which will have the mailing list of the current folder as the recepient. Can be found in the context menu of a folder in KMail, but only after activating "Folder->Mailing List Management". || No ||
|-----
|| kdepim || kmail || mail_send_via ||"Send Queued Messages Via", sends all mails which currently are queued in the outbox, but pops up a menu first asking the user which of his outgoing accounts (SMTP servers) he wants to use. Can be found in the "File" menu of KMail. || No ||
|-----
|| kdepim || kalarm || apps/kalarm || System tray icon, indicating alarms are enabled. Current icon is still the hicolor one. || No ||
|-----
|| kdepim || kalarm || status/kalarm-disabled || System tray icon, indicating alarms are disabled. Current icon still is the hicolor one. || No ||
|-----
|| kdepim || korganizer || actions/view-calendar-time-spent || Doesn't exist yet. an icon representing the new timespent view. || No || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-timeline || Doesn't exist yet. an icon representing the new timeline view. || Done || dmiller
|-----
|| kdepim || korganizer || actions/view-calendar-journal || Doesn't exist yet. an icon representing KOrganizer's journal view. || New ||
|-----
|| kdepim || korganizer || actions/view-calendar-free-busy || Doesn't exist yet. an icon representing freebusy time in a calendar || New ||
|-----
|| kdepim || kontact || birthday || maybe a cake with candles to represent someone's birthday || New ||
|-----
|| kdepim || kontact || anniversary || to represent a wedding anniversary || New ||
|-----
|| kdepim || kontact || special occassion || to represent a general special occassion. examples: holidays, birthdays, graduation, etc || New ||
|-----
|| kdepim || kontact || holiday || a non-religious holiday. examples: independence day, new years, etc || New ||
|-----
|| kdesupport || strigi || strigi || Doesn't exist yet. It should be an owl.|| No ||
|-----
|| kdegames || bovo || bovo || Apps main icon || done || johann_ol
|-----
|| kdegames || katomic || katomic || Apps main icon || No ||
|-----
|| kdegames || kbattleship || kbattleship || Apps main icon || No ||
|-----
|| kdegames || kblackbox || kblackbox || Apps main icon || No ||
|-----
|| kdegames || kbounce || kbounce || Apps main icon || No ||
|-----
|| kdegames || kgoldrunner || kgoldrunner || Apps main icon || No ||
|-----
|| kdegames || kiriki || kiriki || Apps main icon || No ||
|-----
|| kdegames || kjumpingcube || kjumpingcube || Apps main icon || No ||
|-----
|| kdegames || klines || klines || Apps main icon || No ||
|-----
|| kdegames || kmahjongg || kmahjongg || Apps main icon || No ||
|-----
|| kdegames || kmines || kmines || Apps main icon || No ||
|-----
|| kdegames || knetwalk || knetwalk || Apps main icon || done || johann_ol & trouvnez
|-----
|| kdegames || kolf || kolf || Apps main icon || No ||
|-----
|| kdegames || konquest || konquest || Apps main icon || No ||
|-----
|| kdegames || kpat || kpat || Apps main icon || No ||
|-----
|| kdegames || kreversi || kreversi || Apps main icon || No ||
|-----
|| kdegames || ksame || ksame || Apps main icon || No ||
|-----
|| kdegames || kshisen || kshisen || Apps main icon || No ||
|-----
|| kdegames || kspaceduel || kspaceduel || Apps main icon || No ||
|-----
|| kdegames || ksquares || ksquares || Apps main icon || No ||
|-----
|| kdegames || ksudoku || ksudoku || Apps main icon || done || johann_ol
|-----
|| kdegames || ktuberling || ktuberling || Apps main icon || No ||
|-----
|| kdegames || kwin4 || kwin4 || Apps main icon || No ||
|-----
|| kdegames || lskat || lskat || Apps main icon || No ||
|-----
|| kdegames || libkdegames || games-config-options || Old ChooseGameType action, used in configuration panes, to specify game types, variations or options|| Done || piacentini
|-----
|| kdegames || libkdegames || games-solve || Solve action for games, used to be a wizard's wand|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-tiles || Configuration pane icon, used to select the tileset in kmahjongg and kshisen. Could be possibly created from the tilesets SVG graphics in kdegames/libkmahjongg/tilesets|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-background || Configuration pane icon, used to select the field background in kmahjongg and kshisen. Could be reused by other games as a generic background icon|| Done || piacentini
|-----
|| kdegames || libkmahjongg || games-config-board || Configuration pane icon, used to select the board layout in kmahjongg and kshisen. Could be reused by other games as a generic configure levels/boards icon|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-theme || Configuration pane icon, used to select the KGameTheme to be used|| Done || piacentini
|-----
|| kdegames || libkdegames || games-config-custom || Configuration pane icon, used to configure custom game options, or complex settings|| Done || piacentini
|-----
|| kdegames || libkdegames || games-endturn || End turn checkmark|| Done || piacentini
|-----
|| kdenetwork || krdc || krdc-viewonly || Toggles the remote view viewonly / view-control mode. Viewonly means, that the remote desktop shows all updates, but the client does not send actions back to the server. At the moment the kgpg-sign-kgpg is used there. --[[User:Uwolfer|Uwolfer]] 23:11, 28 October 2007 (CET) || No ||
|-----
|| kdenetwork || kget || connect-creating || Shown while trying to connect to a server. --[[User:Uwolfer|Uwolfer]] 21:05, 29 October 2007 (CET) || No ||
|-----
|| kdenetwork || kopete || kopeteavailable || Icon representing the user in an online state. Used to set status to online || No ||
|-----
|| kdenetwork || kopete || kopeteaway || Icon representing the user in an away state. Used to set status to away. NB for this and the following kopetebusy there are overlay icons (small clock faces etc) in kdenetwork/kopete/icons that are used to generate contact status icons at runtime. It would be good if these icons were consistent with the overlay icons || No ||
|-----
|| kdenetwork || kopete || kopetebusy || Icon representing the user in an away state. Used to set status to busy || No ||
|-----
|| kdenetwork || kopete || metacontact_away || Icon representing an IM contact in an away state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_online || Icon representing an IM contact in an online state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_offline || Icon representing an IM contact in an offline state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || metacontact_unknown || Icon representing the user in an unknown state. Used in the contact list || No ||
|-----
|| kdenetwork || kopete || kopete_plugin || Generic icon for extensions - please no literal 'plug' icon as we use this already for network connections || No ||
|-----
|| kdenetwork || kopete || kopete_privacy || Configuring privacy settings || No ||
|-----
|| kdenetwork || kopete || kopete_texteffect || Configuring text formatting special effects || No ||
|-----
|| kdenetwork || kopete || kopete_autoreplace || Configuring text autocorrect rules || No ||
|-----
|| kdenetwork || kopete || highlight || Configuring text highlighting - icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || urlpicpreview || icon exists but only in a low resolution || No ||
|-----
|| kdenetwork || kopete || newmsg || icon flashed in system tray when new messages are received || No ||
|-----
|| kdeutils || kwalletmanager || wallet_open|| kwalletmanager system tray icon when a wallet is open || Done ||
|-----
|| kdeutils || kwalletmanager || wallet_closed || kwalletmanager system tray icon when a wallet is close || Done ||
|-----
|| kdeutils || kwalletmanager || kwalletmanager || kwalletmanager application icon || Done ||
|-----
|}

== Other 3rd party Application Icons ==
For all the other applications

{|rules="all" cellpadding="2" cellspacing="0" align=center style="border:1px solid #999; border-right:2px solid #999; border-bottom:2px solid #999;" width="100%"
|+
! style="background:#efefef;" | Application
! style="background:#efefef;" | Icon Name
! style="background:#efefef;" | Description / Where can be found?
! style="background:#efefef;" | Done?
! style="background:#efefef;" | Assigned To
|-----
|| KSystemlog || KSystemLog icon || [http://websvn.kde.org/trunk/playground/sysadmin/ksystemlog/src/hi128-app-ksystemlog.png?view=markup App icon] - Made by a non-graphic designer developer ;-) || Done (utilites-log-viewer) || dmiller
|-----
|| Tagua || apps/tagua || [http://www.tagua-project.org/chrome/site/banner.png Tagua logo] || Done || dmiller
|-----
|| Tagua || tagua-movelist || toggle [http://www.tagua-project.org/attachment/wiki/Screenshots/nested1.png movelist] || Done - use actions/history ||
|-----
|| Amarok || amarok ||
[http://websvn.kde.org/trunk/extragear/multimedia/amarok/src/images/amarok_icon.svg App icon]. Needs Oxygen colors, we don't really want to change design.
|| No
||
|-----
|| KPlayer || status/media-playlist-repeat ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html loop] through the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the next-to-last button in the second row.
|| No ||
|-----
|| KPlayer || status/media-playlist-shuffle ||
Option to [http://kplayer.sourceforge.net/manual/configuration-playlist.html shuffle] the current playlist. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the last button in the second row.
|| No ||
|-----
|| KPlayer || status/audio-volume-muted ||
This icon already exists in Oxygen, but in only one size, 22x22 I believe. Would like to have a scalable version. [note from jpetso: please also a scalable version for the other audio-volume-* icons]
|| No ||
|-----
|| KPlayer || video-contrast ||
Button that pops up the slider that lets you change the video contrast. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the fourth-to-last button in the first row.
|| No ||
|-----
|| KPlayer || video-brightness ||
Button that pops up the slider that lets you change the video brightness. See [http://kplayer.sourceforge.net/manual/parts.html screenshot], it's the third-to-last button in the first row.
|| No ||
|-----
|| Firefox || apps/firefox || [http://en.www.mozilla.com/img/products/firefox-title.jpg Firefox logo] || No ||
|-----
|| GIMP || apps/gimp || [http://upload.wikimedia.org/wikipedia/commons/5/55/GIMP_Icon.png GIMP logo] || No ||
|-----
|| kopete-cryptography || badsignature || An icon like the 'signature' icon, but it indicates that a digital signature cannot be verified. See [http://websvn.kde.org/*checkout*/trunk/extragear/network/kopete-cryptography/icons/badsignature.png?revision=730086 websvn] for a quick version that I made. This icon is intended to be displayed at 16x16, so I think the red color alone isn't enough to made it's intention quickly obvious, it should have more distinction from 'siganture'. || No ||
|}

= Misc Icon Requests =
* Please see my request on http://www.nabble.com/Suggestion-for-Oxygen:-Highlight-difference-between-Kate-and-KWrite-t4447769.html and the bug report to help you track this wish at: https://bugs.kde.org/show_bug.cgi?id=138170.
Update:Thanks Djmdave, for moving this here. Now the KWrite icon is totally missing. See: http://websvn.kde.org/trunk/KDE/kdebase/runtime/pics/oxygen/128x128/apps/kwrite.png?view=markup and other corresponding directories (scalable 64x64 etc). My request for two distinct icons for Kate and KWrite stands. Please see bug for more details and discussion.

* Partly fixed in svn commit r733637 (fabo), missing all unmount icons and some others (MO Device and ZIP Device) used in *.desktop files:
http://websvn.kde.org/trunk/KDE/kdebase/apps/lib/konq/Templates/

Projects/Oxygen/Missing Icons

2007-11-09T08:44:46Z

Djmdave: kwallet icons have been completed for a while now

Projects/Oxygen/Missing Icons

2007-11-01T13:27:26Z

Djmdave: /* KDE main modules */ preferences-system-login

Projects/Oxygen/Missing Icons

2007-10-31T21:53:02Z

Djmdave: /* General purpose icons */ item-(un)locked added (replaces note2 action icon)

Projects/Oxygen/Missing Icons

2007-10-30T10:59:21Z

Djmdave: /* KDE main modules */ fixing a row that was out of place

Projects/Oxygen/StyleWinDec

2007-10-28T21:26:39Z

Djmdave: /* Incoming New Bugs */ menu icon blurring bug

The current Oxygen style and window decoration for KDE4 can be found in SVN under http://websvn.kde.org/trunk/KDE/kdebase/runtime/kstyles/oxygen and http://websvn.kde.org/trunk/KDE/kdebase/workspace/kwin/clients/oxygen

== Incoming New Bugs ==
* add your entry here and we (the developers) will move it down and prioritize

* The colors of QToolBox is wrong, one can not read anything. This is used in KMail (Settings->Composer->Standart Templates). The captions are unreadable, as they have the same color as the rest of the widget (gray).

* Dockers; the title is positioned too far to the left and it runs into the rounded-border

* In (double) spinboxes the font is positioned one pixel too high. Lowering it one makes it baseline-aligned with labels in front. Unfortunately not possible 
: what about altering the size hints so the whole widget moves down? Trouble is we want them to be the same size as editable comboboxes and lineedits and buttons so those line up. The 1px wrong placement of text is a qt weirdness that gives visual bugs when we try to work around it - believe me - I've spent several hours on this.

* The ok and cancel buttons on dialogs (so called 'control buttons') don't have the same width. Not a style problem 

* Centered group titles pose several problems. Left align group titles instead. See Discussion for more details.

* Window decoration scales the menu icons down resulting in the icons blurring. Interestingly in the kwindecoration kcmshell the preview shows the 16x16/mimetypes/unknown.png icon at its correct 16x16 size, but as soon as the use the deco for real, it starts blurring them. (This is also true for KDE4's Plastik deco). [[User:Djmdave|Djmdave]] 22:26, 28 October 2007 (CET)

== Known Bugs ==
* tabs
** east and west aren't done at all priority
** small glitches in filling inactive tabs priority
* Dockers
** frame when docked can be overwritten releasable
** frame when floating should have rounded corners showstopper
* KHTML integration
** khtml makes illegal assumptions about buttons. Awaits patch review by Maxim showstopper
* KLineEdit
** stylesheets ruin the look. Aseigo says to wait for qt fix showstopper
* Holes in general
** need bigger margins so shadow/glow are not lost?
** fix non-rounded corners when filling (at least) lineedits priority
** with autoFillBackground, corners are overpainted (how to fix this??) priority
* QToolBox not drawn showstopper
* need to audit color role use (see QA #3) showstopper
* Reverse layout is broken
** listview,tablevies paint the frame in LTR place Qt issue 137304 releasable
* progress bars still not like the artist wants priority
* menus not done releasable
** KMenu::addTitle() adds a widget action to display a title in a popup menu. This is not specific to Oxygen, but the widget it creates could use some polishing. (to see this, right click any icon in the system tray)
* windeco
** corners should really be alpha transparent showstopper
* should repaint on globalChange signal (how?) releasable
** this seems to only be a problem for the colors kcm, may not even be a style bug
*headers in tables
**not really done - but the plain color look is acceptable for now releasable
* checkboxes in Q3ListView (Kontact-ToDo) are broken releasable
* Groupboxes
** does not report a minimum size that allows it to show the text on the box. I.e. a groupbox with no contents, the groupbox-title is clipped. releasable
** metrics for checkable groupboxes broken (see discussion for screenshot) priority
* Buttons on KNewStuff download dialog do not appear

== QA ==
* reverse layout
* high-contrast color schemes (i.e. all fg/bg black or white)
* reverse-light/dark color schemes (e.g. light-on-dark buttons with dark-on-light views, etc.)
* tabs, in all directions
* no gray space between scrollbar and the text area it controls.
* sliders, scrollbars, progress - in all orientations and good cross section of values
* content padding works for all controls, does not break sizeToContents functionality
* controls align nicely and controls that should be the same size, are
* no obvious glitches in uidemo

[[Category:Artwork]][[Category:Oxygen]]

Projects/Oxygen/Missing Icons

2007-10-28T15:23:37Z

Djmdave: /* Other 3rd party Application Icons */ log viewer

Projects/Oxygen/Missing Icons

2007-10-28T10:59:35Z

Djmdave: /* KDE main modules */

Projects/Oxygen/Missing Icons

2007-10-27T21:03:07Z

Djmdave: /* General purpose icons */

Talk:Projects/Oxygen/Missing Icons

2007-10-27T15:03:30Z

Djmdave: Image Resize Icon

This is a great idea! Perhaps we need to have some way to track the most requested icons similar to the way bugzilla allows people to vote on issues that need the most attention. I would be willing to help with PHP/MySQL/HTML/CSS to create a solution for this but right now I don't have the time to make it all myself.

== Image Resize Icon ==

There is a generic resize icon in playground/artwork/Oxygen/scribus/ called scale. This is best suited. How it will be included (i assume for gwenview?) im not sure of.

The fd.o name should be transform-scale which i will rename it to when i have created the icon for the other sizes (currently just 16px)

- [[User:Djmdave|Djmdave]] 17:03, 27 October 2007 (CEST)

Projects/Oxygen/Missing Icons

2007-10-27T14:59:31Z

Djmdave: /* General purpose icons */

Projects/Oxygen/Missing Icons

2007-10-27T14:37:51Z

Djmdave: /* KDE main modules */ kwrite >> accessories-text-editor

Projects/Oxygen/Missing Icons

2007-10-26T17:13:44Z

Djmdave: /* Other 3rd party Application Icons */ tagua-movelist -- use history icon

Template talk:Oxygen License

2007-10-18T13:57:28Z

Djmdave: license is wrong

=License is wrong=
Oxygen no longer prohibits redistribution. It is now licensed under CC Share alike/attribution 3.0 and the LGPL v2 or later

http://websvn.kde.org/*checkout*/trunk/KDE/kdebase/runtime/pics/oxygen/COPYING

please change! :) [[User:Djmdave|Djmdave]] 15:57, 18 October 2007 (CEST)

Development/Guidelines/CIG/Icons

2007-10-18T13:45:23Z

Djmdave: /* To Do */ missing icon link

== Oxygen ==
The official KDE 4 icons are the [http://www.oxygen-icons.org Oxygen SVG icons]. These are vector based icons, ready to scale for all resolutions. As the icons are currently under development, they may be viewed via [http://websvn.kde.org/trunk/playground/artwork/Oxygen/ KDE's WebSVN].

* Vector icons can be scaled, and are more efficient: bigger sizes can be rendered with a batch operation.

== License ==
The Oxygen Icon Palette is licensed under the [http://creativecommons.org/licenses/by-nc-nd/2.5/ Creative Commons Attribution - NonCommercial - NoDerivs 2.5 License]

Oxygen Icons are dual licensed under Creative Common Attribution-ShareAlike 3.0 and GNU Library General Public License, version 2 (or at your option) any later version.
See: [http://websvn.kde.org/*checkout*/trunk/KDE/kdebase/runtime/pics/oxygen/COPYING COPYING]

== Contributing ==
To contribute, please familiarize yourself with [http://www.oxygen-icons.org Oxygen]. You may also wish to join the mailing list shown below.

Work on Oxygen is being done using KDE's SVN server, and can be [http://websvn.kde.org/trunk/playground/artwork/Oxygen/ found on the web].

The Oxygen team is typically available on irc on FreeNode - connect to irc.kde.org, and join channel #kde-artists.

== To Do ==
There are always new apps, oops, applications, that need an icon. Contact the Oxygen team to find out more.

A list of missing icons is being maintained [http://techbase.kde.org/Projects/Oxygen/Missing_Icons here.]

== Mailing list & Bugs list ==
You can subscribe to the KDE artists mailing list by sending an e-mail to kde-artists-request@kde.org with just "subscribe" in the header. Sometimes this list is virtually dead, then, nobody knows why, the list is full of life. Be amazed! If you want to take a look at the list before subscribing, you can look at the [http://lists.kde.org/?l=kde-artists archives].

Here is the [http://bugs.kde.org/buglist.cgi?short_desc_type=allwordssubstr&short_desc=&long_desc_type=allwordssubstr&long_desc=&product=artwork&component=general&version=unspecified&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bugidtype=include&bug_id=&votes=&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&order=Reuse+same+sort+as+last+time&cmdtype=doit&newqueryname= Bug list]

== Links ==
*[http://www.kde-look.org/ KDE-look.org]
*[http://home.uwnet.nl/~vita/linux Scripts], including the svg2png4kde script.
*[http://www.kde.org/stuff/clipart.php Clip Art]

Development/Guidelines/CIG/Icons

2007-10-18T13:36:21Z

Djmdave: /* License */ updated license

== Oxygen ==
The official KDE 4 icons are the [http://www.oxygen-icons.org Oxygen SVG icons]. These are vector based icons, ready to scale for all resolutions. As the icons are currently under development, they may be viewed via [http://websvn.kde.org/trunk/playground/artwork/Oxygen/ KDE's WebSVN].

* Vector icons can be scaled, and are more efficient: bigger sizes can be rendered with a batch operation.

== License ==
The Oxygen Icon Palette is licensed under the [http://creativecommons.org/licenses/by-nc-nd/2.5/ Creative Commons Attribution - NonCommercial - NoDerivs 2.5 License]

Oxygen Icons are dual licensed under Creative Common Attribution-ShareAlike 3.0 and GNU Library General Public License, version 2 (or at your option) any later version.
See: [http://websvn.kde.org/*checkout*/trunk/KDE/kdebase/runtime/pics/oxygen/COPYING COPYING]

== Contributing ==
To contribute, please familiarize yourself with [http://www.oxygen-icons.org Oxygen]. You may also wish to join the mailing list shown below.

Work on Oxygen is being done using KDE's SVN server, and can be [http://websvn.kde.org/trunk/playground/artwork/Oxygen/ found on the web].

The Oxygen team is typically available on irc on FreeNode - connect to irc.kde.org, and join channel #kde-artists.

== To Do ==
There are always new apps, oops, applications, that need an icon. Contact the Oxygen team to find out more.

== Mailing list & Bugs list ==
You can subscribe to the KDE artists mailing list by sending an e-mail to kde-artists-request@kde.org with just "subscribe" in the header. Sometimes this list is virtually dead, then, nobody knows why, the list is full of life. Be amazed! If you want to take a look at the list before subscribing, you can look at the [http://lists.kde.org/?l=kde-artists archives].

Here is the [http://bugs.kde.org/buglist.cgi?short_desc_type=allwordssubstr&short_desc=&long_desc_type=allwordssubstr&long_desc=&product=artwork&component=general&version=unspecified&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bugidtype=include&bug_id=&votes=&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&order=Reuse+same+sort+as+last+time&cmdtype=doit&newqueryname= Bug list]

== Links ==
*[http://www.kde-look.org/ KDE-look.org]
*[http://home.uwnet.nl/~vita/linux Scripts], including the svg2png4kde script.
*[http://www.kde.org/stuff/clipart.php Clip Art]

Projects/Oxygen/StyleWinDec

2007-10-18T12:59:58Z

Djmdave: /* Incoming New Bugs */ moved out-of-place bug to ../Missing_Icon_Requests

Projects/Oxygen/Missing Icons

2007-10-18T12:58:40Z

Djmdave: moved out of place request from ../StyleWinDec

Getting Started/Build/KDE4

2007-09-05T11:20:33Z

Djmdave: /* Kubuntu and Debian */ libdbus-1-dev and cmake are listed in the previous section so ive removed these duplicate entries

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]] [[../KDE4/Windows|Instructions for MS Windows]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. There are also tutorials for [[/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[/Mac OS X|Mac OS X]] and [http://solaris.kde.org/ Solaris]. Throughout the tutorial the bash shell is used.

{{warning|Expect a higher risk of build failure '''on Mondays''' when most kdelibs changes are committed. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Required Software ==

The following must be installed first before you can successfully complete this tutorial:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

=== Ark Linux ===
In Ark Linux, the build dependencies you need are installed with:

<code bash>
apt-get install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

If you prefer a graphical interface, select the packages listed above in the "Install Software" tool in Mission Control.

This includes installation of CMake, DBus and Qt - you can skip steps 5, 6 and 7.

=== Kubuntu and Debian ===

In Kubuntu 7.04 (Feisty) and Debian (Testing/Unstable) the build dependencies you need are installed with:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libgpgme11-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev ssh
</code>

In Kubuntu 7.10 (Gutsy) you have to add:
<code bash>
sudo aptitude install dbus-x11
</code>

For a fully functional API documentation framework you also need:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

In openSUSE 10.2 and newer, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Required Packages'''

The packages you will need to install are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the adding the openSUSE Build Service KDE4 Repository to your installation sources.

For openSUSE 10.2 and newer do:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

For older versions of SUSE Linux do:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Now install the following packages (and their dependencies):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

And for fully functional apidox framework you also need:
<code>
graphviz
</code>

CMake binary packages for openSUSE are available from [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

==== Install by hand ====

You can use stable ebuilds just remember to sync your portage before you begin.

Remember: All commands are executed as root.

Required:

We need to allow the following keyword masked ebuilds.

<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Optional:

If you decide not to use the KDE qt-copy, you need to keyword unmask Qt.

<code bash>
echo 'x11-libs/qt' >> /etc/portage/package.keywords
</code>

And now need to mask any Clucene versions above 0.9.16a.

<code bash>
echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

Make sure you have set the berkdb USE flag for redland, otherwise nepomuk won't work.

<code bash>
echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

These are the packages you will need to emerge, I included the update option into the emerge command so you will not re-emerge anything that you might already have installed.

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal'
</code>

You will also need to emerge either 'kde-base/kdesdk' or kde-base/kdesdk-scripts'.

Optional:

If you decided to use Gentoo's version of Qt4, you can emerge it using the following command.

<code bash>
emerge -avu 'x11-libs/qt'
</code>

If you emerged DBUS, CMAKE, QT or HAL you may skip those sections respectively.
Good luck!

==== Install via portage ====

Also you can install the KDE 4 packages directly via
<code bash>
emerge -a <packagename>
</code>

To get the things you need, [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] and then pull in the KDE overlay (which contains experimental KDE ebuilds):
<code bash>
layman -a kde
</code>
After this you need to adjust some USE-flags for KDE 4 and tell portage to use the testing KDE 4 ebuilds instead of the stable KDE 3 ones.

That way portage will do the dependency tracking for you.

Detailed instructions on building KDE 4 in Gentoo via portage can be found in the [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. They are discussed in the thread [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. You will probably also want to modify the path to make sure it doesn't include your kde3 paths. Also if you want to use KDevelop to develop KDE 4 applications you may pass the ''-GKDevelop3'' flag to the ''cmake'' command (to make CMake generate KDevelop project files, it will help to avoid rebuilding in the future, see [[Getting_Started/Set_up_KDE_4_for_development#Setting_up_the_environment|this]]).
To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
ssh -X kde-devel@localhost
</code>

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.
On Ark Linux, you can skip this step - {{path|/bin/sh}} is {{path|bash}} on Ark Linux.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade. You probably want to skip building the bindings until/unless you know you will be building HAL (see below).

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 of the following instructions should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure

# if you will be building HAL, you also need the glib bindings
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

The steps for building the glib bindings are similar to the above.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. You should use the copy in the KDE Subversion servers. (note: some distros, like Debian, tend to supply Qt with patches from KDE svn applied, so you may want to cheat and use precompiled Qt from your distro)

=== The Recipe ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# if we don't install, we'll just clear obj files to
# save disk space
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -delete ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-6). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 7) and install (line 10) Qt. If install dir is the same as the current dir (line 8), then we just free some space (line 9) instead. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. '''Note:''' You may need to run <tt>xhost +local:kde-devel</tt> as your regular kde3 user to run this application. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== HAL ==

{{tip|You can use qdbusviewer to see if you have org.freedesktop.hal. If not, you might need a newer version of hal. If you have org.freedesktop.hal, you probably don't need to, and don't ''want'' to, roll your own HAL.}}

If your system requires you to build a newer version of HAL, there's a decent chance you'll need to build other stuff as well, some of which may not be straight forward. Since this should only be required for older distros, instructions are on [[Getting_Started/Build/HAL| a separate page]].

== kdesupport ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, QImageBlitz for image manipulation needed in kdebase, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/kde/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== Troubleshooting ===
If you get
cmakekde: command not found
then you have to go manualy into the kdesupport directory in ~ and execute the command cmakekde. if this still doesnt work, then something is wrong with your bashrc.

If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

If you get
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
see [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Using Subversion with KDE]

If you get
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
take a second look in the .bashrc file described above, are paths correct? Alternatively, you may see this error if you decided to use a distribution installed version of qt4 and skipped the Qt install above. Either install qt-copy as describe above, or "sudo make install". If you use "sudo make install", make sure you that you change the ownership back to your user for some of the ~/kde subdirectories that were effected by using sudo (ie. "<tt>sudo chown -R kde-devel:kde-devel ~/kde</tt>").

== kdelibs ==

We can now move on to building KDE's base libraries.

=== The Recipe ===
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/kde/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>) If the message stays, run 'svn status' in the kdelibs directory and remove all files labeled with '?'.
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, remove CMakeCache.txt and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/kde/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

=== Troubleshooting ===
If you have trouble compiling kdepimlibs:
* the cmakekde command may require a later version of the gpgme library. This is available from the project's web site: http://www.gnupg.org/(en)/download/index.html - please note that the build of gpgme also requires libgpg-error, also available from the same location. Both libraries are installed by the "./configure", "make" and "sudo make install" sequence, with the gpgme library configured with the additional "--with-gpg-error-prefix" parameter. You may need to overwrite your existing "/usr/bin/gpgme-config" file with the newer version for the kdepimlibs to pick up the new install.
* if you get the error "cannot find -lpth" from /usr/bin/ld, then make sure you have The GNU Portable Threads (libpth-dev for Debian).

== kdebase ==
kdebase is divided into three parts:
* '''apps'''
:This contains applications like Dolphin or KWrite.
* '''runtime'''
:This contains things needed by every application at runtime, like icons. It is a required dependency for each KDE application, so you have to compile and install this.
* '''workspace'''
:This contains things specific to the KDE desktop, like Plasma or the window manager. Most stuff here depends on X11. You only need it if you want to build a full KDE desktop.

You can build all of kdebase at once, which is described in the recipe below. If you only want to build kdebase-runtime, which is the only requirement, you can replace <code bash>cd kdebase</code> with <code bash>cd kdebase/runtime</code> in the receipe below.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you do not have those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get an error complaining about a missing variable X11_Xrandr_LIB, you need the devel package for libxrandr (libxrandr-devel on ubuntu-systems)
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) ", try editing CMakeCache.txt and setting QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.so

* if you get messages as "KDE4_INSTALL_HANDBOOK() is deprecated. Remove it please. Now all is done in KDE4_CREATE_HANDBOOK." then, either find the files containing the offending line and comment it out manually, or run the following script in ~/kde/src/KDE/kdebase: [http://www.plamadeala.com/files/macros_corrector.sh macros_corrector.sh]. It will just REMOVE the line that has "kde4_create_handbook" in it from all the found files.

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Another, even easier method involves downloading this [[Doxyfile]] to your local system. Then simply change directory to where you want to create the documentation and run
<code bash>
% doxygen /path/to/Doxyfile
</code>
Then review the file {{path|doxygen.log}} to see the doxygen errors and warnings. You'll find the actual documentation in the {{path|apidocs}} subdirectory.

== Staying up to date ==

In order to keep the kde4 installation up to date, each of the modules installed should be updated periodically. As Monday is the day for big changes in kdelibs, Tuesday may be the best day to do this. For each module checked out, run <tt>svn up</tt> and <tt>make</tt>.

For example:
<code bash>
cs kdesupport # cs is not a typo
svn up
cb # cb is not a typo
make -j2 VERBOSE=1 && make install
</code>

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Projects/Oxygen/namingSpec/actions

2007-09-03T08:25:14Z

Djmdave: /* Specification compliance of icon names */ corrected those not in spec

Only partially ready for consumption. We already found out about which Oxygen icons already conform to the spec, but the ones that don't conform are not yet listed in here, and there's not yet a plan at the moment on how to proceed with those.

== Specification compliance of icon names ==

Icon names without notes already exist in the freedesktop.org icon naming specification.

<pre>
about-kde -> help-about-kde **
add-user -> list-add-user **
application-exit OK
ark-adddir -> list-add-directory-archive **
ark-addfile -> list-add-file-archive **
ark-delete -> list-remove-file-archive **
ark-extract -> archive-extract *
ark-view -> document-preview-archive **
battery-discharging-000 -> status/battery-low-000 **
battery-discharging-020 -> status/battery-low
battery-discharging-040 -> status/battery-caution
battery-discharging-060 -> status/battery-060 **
battery-discharging-080 -> status/battery-080 **
battery-discharging-100 -> status/battery-100 **
battery-charging-000 -> status/battery-charging-low-000 **
battery-charging-020 -> status/battery-charging-low **
battery-charging-040 -> status/battery-charging-caution **
battery-charging-060 -> status/battery-charging-060 **
battery-charging-080 -> status/battery-charging-080 **
battery-charging-100 -> status/battery-charging-100 **
there's already text-center
compfile -> run-build-file **
delete-user -> list-remove-user **
dialog-apply OK *
dialog-cancel OK
dialog-close OK
dialog-error -> status/dialog-error
dialog-information -> status/dialog-information
dialog-ok OK
dialog-warning -> status/dialog-warning
document-new OK (or "new-document", wait for the
outcome of the discussion)
document-open OK (or "open", wait for the
outcome of the discussion)
document-open-recent OK (or "open-recent", wait for the
outcome of the discussion)
document-print OK
document-print-preview OK
document-properties OK
document-revert OK
document-save OK (or "save", wait for the
outcome of the discussion)
document-save-as OK (or "save-as", wait for the
outcome of the discussion)
edit OK *
editshred -> edit-delete-shred **
edit-add OK *
edit-clear OK (Note: Only in CVS,
not yet in 0.8 of the spec.)
edit-copy OK
edit-cut OK
edit-delete OK *
edit-find OK
edit-paste OK
edit-redo OK
edit-undo OK
edit-user OK **
(In case "edit" is approved.)
folder-new OK (or "new-folder", wait for the
outcome of the discussion)
folder-open -> status/folder-open
format-indent-less OK
format-indent-more OK
format-justify-center OK
format-justify-left OK
format-justify-right OK
format-justify-fill OK
format-text-bold OK
format-text-italic OK
format-text-strikethrough OK
format-text-underline OK
format-font-size-less OK **
format-font-size-more OK **
format-line-spacing-double OK **
format-line-spacing-normal OK **
format-line-spacing-triple OK **
format-text-subscript OK **
format-text-superscript OK **
go-bottom OK
go-down OK
go-first OK
go-home OK
goto-page -> go-jump
go-last OK
go-next OK
go-previous OK
go-top OK
go-up OK
help-contents OK
help-whatsthis -> help-contextual *
identity -> contact-new
(maybe add a "new" sparkle?)
list-add OK
list-remove OK
mail-delete -> edit-delete-mail
mail-forward OK
mail-get -> mail-receive *
mail-ham -> mail-mark-notjunk
mail-message-new OK (or "new-message-mail", wait for
the outcome of the discussion)
mail-new -> svn rm,
in favor of mail-message-new
mail-reply-all OK
mail-reply-sender OK with the current spec, but in
order to enable mail-reply-list,
we rather want this to be
mail-reply.
mail-replylist -> mail-reply-list ** (see above)
mail-send OK
make-kdevelop -> run-build **
media-eject OK
media-playback-pause OK
media-playback-start OK
media-playback-stop OK
media-playlist-clear -> edit-clear-playlist **
media-playlist-refresh -> view-refresh-playlist **
media-record OK
media-seek-backward OK
media-seek-forward OK
media-skip-backward OK
media-skip-forward OK
newfont -> list-add-font
object-rotate-left OK
object-rotate-right OK
password -> status/dialog-password
process-stop OK (Note: Only in CVS,
not yet in 0.8 of the spec.)
save-all -> document-save-all *
(or save-all *, wait for the
outcome of the discussion)
switchuser -> system-switch-user *
system-lock-screen OK
system-log-out OK
system-run OK (or "run", wait for the
outcome of the discussion)
system-search OK (suggest to rename to
system-find, for consistency)
tab-breakoff -> tab-detach *
tab-duplicate OK *
tab-new -> tab-new-background **
tab-new-raised -> tab-new *
tab-remove -> tab-close *
(in accordance to window-close)
tools-check-spelling OK
viewmag1 -> zoom-original
view-fullscreen OK
view-refresh OK
view-restore OK
window-close OK (or "close-window", wait for the
outcome of the discussion)
window-new OK (or "new-window", wait for the
outcome of the discussion)
zoom-original -> svn rm, or zoom *
zoom-best-fit -> zoom-fit-best
zoom-in OK
zoom-out OK
* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
it's not really suited to be a standard icon
</pre>

== To do for Oxygen ==

Icons that are in the spec, but not yet in Oxygen's actions/ (after renaming) so they need to be added. Descriptions taken from the specification

<pre>
address-book-new
The icon used for the action to create a new address book.
(or "new-address-book", depending on the outcome
of the discussion.)

appointment-new
The icon used for the action to create a new appointment
in a calendaring application. (or "new-appointment",
depending on the outcome of the discussion)

document-page-setup
The icon for the page setup action of a document editor.

edit-find-replace
The icon for the find and replace action.

edit-select-all
The icon for the select all action.

format-text-direction-ltr
The icon for the left-to-right text formatting action.

format-text-direction-rtl
The icon for the right-to-left formatting action.

help-about
The icon for the About item in the Help menu.
(Editor's note: not used in KDE, probably a copy of
the "(i)" icon is sufficient.)

help-faq
The icon for the FAQ item in the Help menu.
(Editor's note: not used in KDE either, at the moment.)

insert-image
The icon for the insert image action of an application.

insert-link
The icon for the insert link action of an application.

insert-object
The icon for the insert object action of an application.

insert-text
The icon for the insert text action of an application.

mail-mark-important
The icon for the mark as important action of an
electronic mail application.

mail-mark-junk
The icon for the mark as junk action of an
electronic mail application.

mail-mark-read
The icon for the mark as read action of an
electronic mail application.

mail-mark-unread
The icon for the mark as unread action of an
electronic mail application.

mail-send-receive
The icon for the send and receive action of an
electronic mail application.

object-flip-horizontal
The icon for the action to flip an object horizontally.

object-flip-vertical
The icon for the action to flip an object vertically.

view-sort-ascending
The icon used for the "Sort Ascending" item in the
application's "View" menu, or in a button for
changing the sort method for a list.

view-sort-descending
The icon used for the "Sort Descending" item in the
application's "View" menu, or in a button for
changing the sort method for a list.
</pre>

== To do for Oxygen *and* the spec ==

Icons that are neither in the spec nor in Oxygen but should be added to both.

<pre>
insert-table
The icon for the insert table action of an application.
</pre>

== Summary of the suggested changes and additions ==

The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.

<pre>
archive-extract
The icon used for the action that extracts files and directories
from an archive.

dialog-apply
The icon used for the "Apply" button that might appear
in dialog windows.

edit
The icon for the generic edit action.
(Rationale: There are a lot of things that need to be edited:
bookmarks, contacts, todos, away messages, fill/stroke colors,
app specific item properties of any kind, ...
There should be a generic edit icon as a common ground
and fallback for these use cases.)

help-contextual
The icon for the contextual help / "What's this" icon
in the Help menu.

insert-table
The icon for the insert table action of an application.

mail-receive
The icon for the receive action of an
electronic mail application.

mail-reply-sender -> mail-reply
(Rationale: In order to support more reply methods than
the expected ones. KMail, at least, has "Reply" as
"intelligent reply" - automatically do the right thing -
and also "Reply to all", "Reply to author" and
"Reply to mailing list". The latter is not in the spec,
and doesn't need to be, but in order to enable
mail-reply-list, we need a mail-reply fallback.)

system-switch-user
The icon used for the "Switch User" item in the
desktop's panel application.

system-search -> system-find
The icon used for the "Find Files/Folders" item in the
desktop's panel application.
(Rationale: For consistency - edit-find also uses Find,
and there's no good reason to use Search here.)

tab-detach
The icon used for the "Detach Tab" action.

tab-duplicate
The icon used for the "Duplicate Tab" action.

tab-new (or possibly new-tab, see below)
tab-remove (or possibly close-tab, see below)

zoom-fit-height
The icon used for the "Zoom to Height" item
in the application's "View" menu.

zoom-fit-width
The icon used for the "Zoom to Width" item
in the application's "View" menu.

zoom-fit-best (instead of zoom-best-fit)
</pre>

And now for the radical stuff:

<pre>
new
The icon for the create action.
(Rationale: Right now, the spec has quite a number of *-new
icons, but is totally unflexible when it comes to adding
other stuff that can be created. I propose edit-create as a
basis and fallback for all "new" icons, regardless if they
create documents, mails, podcasts, windows, menu entries in
the start menu editor, classes and functions in integrated
development environments, whatever. If this icon is there,
every app and KDE core library can have "new" items while
staying specification compliant.)
(Consequences for existing icons in the spec:
address-book-new -> new-address-book
appointment-new -> new-appointment
contact-new -> new-contact
document-new -> new-document
folder-new -> new-folder
mail-message-new -> new-message-mail
window-new -> new-window)
</pre>

Of course, doing that breaks the current namespacing scheme
of the spec's actions category, as for example document-new
is ripped apart from the other document icons. I think this
is ok for actions that are not solely specific to
documents/windows/dialogs, because it is important for
extensibility, hence the idea of fallbacks.

Consequently, there should be at least one more "generalization":

<pre>
close
The icon for the close action.
(Consequences for existing icons in the spec:
dialog-close -> close-dialog
window-close -> close-window)
(Opens up opportunities for:
close-document
close-tab
close-project)
</pre>

Projects/Oxygen/namingSpec/actions

2007-09-03T08:17:26Z

Djmdave: /* Specification compliance of icon names */ text formattings

Only partially ready for consumption. We already found out about which Oxygen icons already conform to the spec, but the ones that don't conform are not yet listed in here, and there's not yet a plan at the moment on how to proceed with those.

== Specification compliance of icon names ==

Icon names without notes already exist in the freedesktop.org icon naming specification.

<pre>
about-kde -> help-about-kde **
add-user -> list-add-user **
application-exit OK
ark-adddir -> list-add-directory-archive **
ark-addfile -> list-add-file-archive **
ark-delete -> list-remove-file-archive **
ark-extract -> archive-extract *
ark-view -> document-preview-archive **
battery-discharging-000 -> status/battery-low-000 **
battery-discharging-020 -> status/battery-low
battery-discharging-040 -> status/battery-caution
battery-discharging-060 -> status/battery-060 **
battery-discharging-080 -> status/battery-080 **
battery-discharging-100 -> status/battery-100 **
battery-charging-000 -> status/battery-charging-low-000 **
battery-charging-020 -> status/battery-charging-low **
battery-charging-040 -> status/battery-charging-caution **
battery-charging-060 -> status/battery-charging-060 **
battery-charging-080 -> status/battery-charging-080 **
battery-charging-100 -> status/battery-charging-100 **
there's already text-center
compfile -> run-build-file **
delete-user -> list-remove-user **
dialog-apply OK *
dialog-cancel OK
dialog-close OK
dialog-error -> status/dialog-error
dialog-information -> status/dialog-information
dialog-ok OK
dialog-warning -> status/dialog-warning
document-new OK (or "new-document", wait for the
outcome of the discussion)
document-open OK (or "open", wait for the
outcome of the discussion)
document-open-recent OK (or "open-recent", wait for the
outcome of the discussion)
document-print OK
document-print-preview OK
document-properties OK
document-revert OK
document-save OK (or "save", wait for the
outcome of the discussion)
document-save-as OK (or "save-as", wait for the
outcome of the discussion)
edit OK *
editshred -> edit-delete-shred **
edit-add OK *
edit-clear OK (Note: Only in CVS,
not yet in 0.8 of the spec.)
edit-copy OK
edit-cut OK
edit-delete OK *
edit-find OK
edit-paste OK
edit-redo OK
edit-undo OK
edit-user OK **
(In case "edit" is approved.)
folder-new OK (or "new-folder", wait for the
outcome of the discussion)
folder-open -> status/folder-open
format-indent-less OK
format-indent-more OK
format-justify-center OK
format-justify-left OK
format-justify-right OK
format-justify-fill OK
format-text-bold OK
format-text-italic OK
format-text-strikethrough OK
format-text-underline OK
format-font-size-less OK
format-font-size-more OK
format-line-spacing-double OK
format-line-spacing-normal OK
format-line-spacing-triple OK
format-text-subscript OK
format-text-superscript OK
go-bottom OK
go-down OK
go-first OK
go-home OK
goto-page -> go-jump
go-last OK
go-next OK
go-previous OK
go-top OK
go-up OK
help-contents OK
help-whatsthis -> help-contextual *
identity -> contact-new
(maybe add a "new" sparkle?)
list-add OK
list-remove OK
mail-delete -> edit-delete-mail
mail-forward OK
mail-get -> mail-receive *
mail-ham -> mail-mark-notjunk
mail-message-new OK (or "new-message-mail", wait for
the outcome of the discussion)
mail-new -> svn rm,
in favor of mail-message-new
mail-reply-all OK
mail-reply-sender OK with the current spec, but in
order to enable mail-reply-list,
we rather want this to be
mail-reply.
mail-replylist -> mail-reply-list ** (see above)
mail-send OK
make-kdevelop -> run-build **
media-eject OK
media-playback-pause OK
media-playback-start OK
media-playback-stop OK
media-playlist-clear -> edit-clear-playlist **
media-playlist-refresh -> view-refresh-playlist **
media-record OK
media-seek-backward OK
media-seek-forward OK
media-skip-backward OK
media-skip-forward OK
newfont -> list-add-font
object-rotate-left OK
object-rotate-right OK
password -> status/dialog-password
process-stop OK (Note: Only in CVS,
not yet in 0.8 of the spec.)
save-all -> document-save-all *
(or save-all *, wait for the
outcome of the discussion)
switchuser -> system-switch-user *
system-lock-screen OK
system-log-out OK
system-run OK (or "run", wait for the
outcome of the discussion)
system-search OK (suggest to rename to
system-find, for consistency)
tab-breakoff -> tab-detach *
tab-duplicate OK *
tab-new -> tab-new-background **
tab-new-raised -> tab-new *
tab-remove -> tab-close *
(in accordance to window-close)
tools-check-spelling OK
viewmag1 -> zoom-original
view-fullscreen OK
view-refresh OK
view-restore OK
window-close OK (or "close-window", wait for the
outcome of the discussion)
window-new OK (or "new-window", wait for the
outcome of the discussion)
zoom-original -> svn rm, or zoom *
zoom-best-fit -> zoom-fit-best
zoom-in OK
zoom-out OK
* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
it's not really suited to be a standard icon
</pre>

== To do for Oxygen ==

Icons that are in the spec, but not yet in Oxygen's actions/ (after renaming) so they need to be added. Descriptions taken from the specification

<pre>
address-book-new
The icon used for the action to create a new address book.
(or "new-address-book", depending on the outcome
of the discussion.)

appointment-new
The icon used for the action to create a new appointment
in a calendaring application. (or "new-appointment",
depending on the outcome of the discussion)

document-page-setup
The icon for the page setup action of a document editor.

edit-find-replace
The icon for the find and replace action.

edit-select-all
The icon for the select all action.

format-text-direction-ltr
The icon for the left-to-right text formatting action.

format-text-direction-rtl
The icon for the right-to-left formatting action.

help-about
The icon for the About item in the Help menu.
(Editor's note: not used in KDE, probably a copy of
the "(i)" icon is sufficient.)

help-faq
The icon for the FAQ item in the Help menu.
(Editor's note: not used in KDE either, at the moment.)

insert-image
The icon for the insert image action of an application.

insert-link
The icon for the insert link action of an application.

insert-object
The icon for the insert object action of an application.

insert-text
The icon for the insert text action of an application.

mail-mark-important
The icon for the mark as important action of an
electronic mail application.

mail-mark-junk
The icon for the mark as junk action of an
electronic mail application.

mail-mark-read
The icon for the mark as read action of an
electronic mail application.

mail-mark-unread
The icon for the mark as unread action of an
electronic mail application.

mail-send-receive
The icon for the send and receive action of an
electronic mail application.

object-flip-horizontal
The icon for the action to flip an object horizontally.

object-flip-vertical
The icon for the action to flip an object vertically.

view-sort-ascending
The icon used for the "Sort Ascending" item in the
application's "View" menu, or in a button for
changing the sort method for a list.

view-sort-descending
The icon used for the "Sort Descending" item in the
application's "View" menu, or in a button for
changing the sort method for a list.
</pre>

== To do for Oxygen *and* the spec ==

Icons that are neither in the spec nor in Oxygen but should be added to both.

<pre>
insert-table
The icon for the insert table action of an application.
</pre>

== Summary of the suggested changes and additions ==

The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.

<pre>
archive-extract
The icon used for the action that extracts files and directories
from an archive.

dialog-apply
The icon used for the "Apply" button that might appear
in dialog windows.

edit
The icon for the generic edit action.
(Rationale: There are a lot of things that need to be edited:
bookmarks, contacts, todos, away messages, fill/stroke colors,
app specific item properties of any kind, ...
There should be a generic edit icon as a common ground
and fallback for these use cases.)

help-contextual
The icon for the contextual help / "What's this" icon
in the Help menu.

insert-table
The icon for the insert table action of an application.

mail-receive
The icon for the receive action of an
electronic mail application.

mail-reply-sender -> mail-reply
(Rationale: In order to support more reply methods than
the expected ones. KMail, at least, has "Reply" as
"intelligent reply" - automatically do the right thing -
and also "Reply to all", "Reply to author" and
"Reply to mailing list". The latter is not in the spec,
and doesn't need to be, but in order to enable
mail-reply-list, we need a mail-reply fallback.)

system-switch-user
The icon used for the "Switch User" item in the
desktop's panel application.

system-search -> system-find
The icon used for the "Find Files/Folders" item in the
desktop's panel application.
(Rationale: For consistency - edit-find also uses Find,
and there's no good reason to use Search here.)

tab-detach
The icon used for the "Detach Tab" action.

tab-duplicate
The icon used for the "Duplicate Tab" action.

tab-new (or possibly new-tab, see below)
tab-remove (or possibly close-tab, see below)

zoom-fit-height
The icon used for the "Zoom to Height" item
in the application's "View" menu.

zoom-fit-width
The icon used for the "Zoom to Width" item
in the application's "View" menu.

zoom-fit-best (instead of zoom-best-fit)
</pre>

And now for the radical stuff:

<pre>
new
The icon for the create action.
(Rationale: Right now, the spec has quite a number of *-new
icons, but is totally unflexible when it comes to adding
other stuff that can be created. I propose edit-create as a
basis and fallback for all "new" icons, regardless if they
create documents, mails, podcasts, windows, menu entries in
the start menu editor, classes and functions in integrated
development environments, whatever. If this icon is there,
every app and KDE core library can have "new" items while
staying specification compliant.)
(Consequences for existing icons in the spec:
address-book-new -> new-address-book
appointment-new -> new-appointment
contact-new -> new-contact
document-new -> new-document
folder-new -> new-folder
mail-message-new -> new-message-mail
window-new -> new-window)
</pre>

Of course, doing that breaks the current namespacing scheme
of the spec's actions category, as for example document-new
is ripped apart from the other document icons. I think this
is ok for actions that are not solely specific to
documents/windows/dialogs, because it is important for
extensibility, hence the idea of fallbacks.

Consequently, there should be at least one more "generalization":

<pre>
close
The icon for the close action.
(Consequences for existing icons in the spec:
dialog-close -> close-dialog
window-close -> close-window)
(Opens up opportunities for:
close-document
close-tab
close-project)
</pre>

User:Djmdave/IconNamingTextFormatting

2007-09-03T08:16:40Z

Djmdave: Removing all content from page

User:Djmdave/IconNamingTextFormatting

2007-09-02T13:12:16Z

Djmdave: New page: Note: I'll move these to the http://techbase.kde.org/Projects/Oxygen/namingSpec/actions when they're approved :-) <pre> fontsizedown-koffice format-font-size-less fontsizeup-koffice f...

Note: I'll move these to the http://techbase.kde.org/Projects/Oxygen/namingSpec/actions when they're approved :-)

<pre>
fontsizedown-koffice format-font-size-less
fontsizeup-koffice format-font-size-more
spacedouble-koffice format-line-spacing-double
spacesimple-koffice format-line-spacing-normal
spacetriple-koffice format-line-spacing-triple
text-sub format-text-subscript
text-super format-text-superscript
</pre>

Projects/Oxygen/namingSpec/apps

2007-09-01T15:01:14Z

Djmdave: /* Specification compliance of icon names */

== Specification compliance of icon names ==

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

'''Generic Application Names (in the spec):'''

<pre>
accessories-calculator OK
accessories-character-map OK
accessories-dictionary OK
help-browser OK
kaddressbook -> office-addressbook **
kcall -> internet-telephony
kmail -> internet-mail **
korganizer -> office-calendar **
ksnapshot -> accessories-screen-shot **
kuickshow -> graphics-viewer-image **
kwallet OK
kwrite -> accessories-text-editor
multimedia-volume-control OK
okular -> graphics-viewer-document **
preferences-desktop-accessibility OK
preferences-desktop-font OK
preferences-desktop-keyboard OK
preferences-desktop-locale OK
preferences-desktop-multimedia Needed
preferences-desktop-screensaver OK
preferences-desktop-sound OK **
preferences-desktop-theme Needed
preferences-desktop-wallpaper OK
preferences-system-windows OK **
system-file-manager OK
system-software-update OK
utilities-file-archiver OK **
utilities-system-monitor OK
utilities-terminal OK
</pre>

'''Generic Application Names (not in the spec):'''
<pre>
preferences-desktop-cryptography OK
preferences-desktop-notifications OK
preferences-system-bluetooth OK
preferences-system-time OK
</pre>

'''Generic Tango icons in Oxygen:'''

<pre>
krfb -> preferences-desktop-remote-desktop
</pre>

'''Other application icons:'''

Most other application icons should go to their home modules instead of residing in kdelibs - this not only makes for a better overview but also reduces disk space in case not all modules are installed. And, of course, prevents icons being misused for wrong usages.

<pre>
acroread ?? needs a spec type name for fallback
RFC: "viewer-document-acroread"
basket -> move to wherever basket lives
digikam -> move to extragear/graphics/digikam
gwenview -> move to kdegraphics/gwenview
k3b -> move to extragear/multimedia/k3b
as multimedia-disc-creator-k3b
kaffeine -> move to extragear/kaffeine
as multimedia-player-kaffeine
kalzium -> move to kdeedu/kalzium
kanagram -> move to kdeedu/kanagram
kate -> move to kdesdk/kate as
accessories-text-editor-kate
kblogger -> move to wherever kblogger lives
kbruch -> move to kdeedu/kbruch
kbugbuster -> move to kdesdk/kbugbuster
kchart -> move to koffice/kchart
kcmkwm -> svn rm
kcolorchooser -> move to kdegraphics/kcolorchooser
kdeprint-printer -> svn rm,
we already have devices/printer
KEduca -> keduca (right?), and move to
wherever keduca lives
kexi -> move to koffice/kexi
kfind ?? svn rm,
replaced by actions/system-search
kgeography -> move to kdeedu/kgeography
kget -> move to kdenetwork/kget
khangman -> move to kdeedu/khangman
kiten -> move to kdeedu/kiten
kjournal ?? does it still exist? if no, svn rm.
if yes, move to wherever it lives.
KLatin -> klatin (right?), and move to
wherever klatin lives
klettres -> move to kdeedu/klettres
klipper -> move to kdebase/klipper
kmplayer -> move to extragear/multimedia/kmplayer
as multimedia-player-kmplayer
KmPlot -> kmplot, and move to kdeedu/kmplot
knotes -> move to kdepim/knotes
(and to the notes plasmoid?)
knotify ?? does it still exist? if no, svn rm.
if yes, move to wherever it lives.
kolf -> move to kdegames/kolf
konqueror -> move to kdebase/konqueror as
internet-web-browser-konqueror
kontact -> move to kdepim/kontact
konversation -> move to extragear/network/konversation
konv-message -> move to extragear/network/konversation,
and rename it to konversation-message
kopete -> move to kdenetwork/kopete
KPercentage -> kpercentage, and move to
kdeedu/kpercentage
krita -> move to koffice/krita
kruler -> move to kdegraphics/kruler
ksim-cpu ?? find out which apps use this icon
(or devices/cpu), and make it private
KSniffer -> ksniffer, and move to
playground/network/ksniffer
kstars -> move to kdeedu/kstars
kteatime -> move to kdetoys/kteatime
ktorrent -> move to extragear/network/ktorrent
once the KDE 4 port is finished
KVerbos -> kverbos, and move to
playground/edu/kverbos
KWordQuiz -> kwordquiz, and move to
kdeedu/kwordquiz
kword -> move to koffice/kword
laptop-battery ?? another battery icon? svn rm,
or replace devices/battery
with this one
marble -> move to kdeedu/marble
none -> svn rm
plasmagik -> move to
playground/base/plasma/plasmagik
wine OK
x OK ** [see Discussion]

* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
it's not really suited to be a standard icon
</pre>

== To do for Oxygen ==

Icons that are in the spec, but not yet in Oxygen's apps/ (after renaming) so they need to be added. Descriptions taken from the specification.

<pre>
preferences-desktop-multimedia
The icon used for the desktop's multimedia preferences.

preferences-desktop-theme
The icon used for the desktop's theme preferences.
</pre>

== To do for Oxygen - not in the spec ==

Icons that are not specified and do not currently exist as well, but are needed for KDE applications (and not blatantly obvious). Yes, I am aware that some of those are bad (if not outright evil) names. That comes from preferences-desktop-peripherals being classified in the "desktop" preferences subgroup, which is very wrong imho. We need to fix this in the spec (see the suggestions of the [[Projects/Oxygen/namingSpec/categories|categories]] page), but until then, I stay with specification conform names.

<pre>
preferences-desktop-display
The icon for the "Display" KCM.

preferences-desktop-effects
The icon for the "Desktop Effects; KCM. (New in KDE 4.)

preferences-desktop-gaming
The icon for the "Joystick" KCM.

preferences-desktop-launch-feedback
You can guess. Really, it's easy.

preferences-desktop-mouse
The icon for the "Mouse" KCM.

preferences-desktop-panel
The icon for the "Panels" KCM.

preferences-desktop-user
The icon for the "About me" KCM in KDE 4's System Settings
(which was named "Password & User Account in KDE 3).

preferences-system-login
The icon for the "Login Manager" KCM.

preferences-system-power-management
The icon for the "Power Control" KCM. (Although I'm not sure if
this will still exist for KDE 4, at least in its current form.)

preferences-system-network-share
The icon for the "File Sharing" KCM.

preferences-system-session
The icon for the "Session Manager" KCM.
(This icon also exists in the Tango set.)

preferences-system-splash
The icon for the "Splash Screen" KCM.
</pre>

== Optional icons ==

We don't absolutely need those because they are covered by fallbacks: if these icons don't exist, they've got a sensible fallback.

<pre>
preferences-desktop-display-randr
The icon for the "Size & Orientation" KCM.

preferences-desktop-keyboard-khotkeys
The icon for the "KHotKeys" KCM.

preferences-desktop-panel-taskbar
The icon for the "Taskbar" KCM.

preferences-desktop-user-smartcard
The icon for the "Smartcards" KCM.
(Was "identity" in KDE 3, and is really not necessary.)

preferences-system-solid
The icon for the "Solid" KCM. (New in KDE 4.)

preferences-system-windows-effects
The icon for the "Window Effects" KCM. (New in KDE 4.)

preferences-system-windows-decoration
The icon for the "Window Decorations" KCM.

preferences-system-windows-specific
The icon for the "Window-Specific Settings" KCM.
</pre>

== Icons in Tango, but not in the spec ==

We don't need to have those, but if we do they should be named this way:

<pre>
internet-group-chat
For a possible generic instant messager icon.
*Very* optional though, as we already have branded
Kopete and Konversation icons.

internet-mail
We already have this from the previous "kmail" icon.

internet-news-reader
Instead of "knode".

internet-web-browser
For a possible generic browser icon. *Very* optional though,
as we already have a branded Konqueror icon.

office-calendar
We already have this from the previous "korganizer" icon.

preferences-desktop-assistive-technology
Tango does this as preferences-desktop-accessibility
plus an emblem-style gear icon at the lower right.
Hardly necessary to have.

preferences-desktop-sound
Go Phonon go. (Done.)

preferences-system-network-proxy
We do have proxy settings in KDE 3, this might make sense.

preferences-system-session
The icon for the session management settings.

preferences-system-windows
Done.

system-installer
Adept, Yast, Pirut, Smart, or whatever else is out there.

system-users
Seems to fit KUser or Guidance's "User Management" module.
</pre>

Projects/Oxygen/namingSpec/places

2007-08-31T20:24:47Z

Djmdave:

== Specification compliance of icon names ==

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

<pre>
file-broken -> rework into emblems/emblem-unreadable.
Currently only in use by apps/libs as
"image could not be loaded" substitute.
folder OK
folder-home -> user-home
folder-red,
folder-blue,
folder-brown,
folder-cyan,
folder-green,
folder-grey,
folder-orange,
folder-violet,
folder-yellow -> Keep for now, but try to bring up some
substitute functionality, like tinting
folders by code, or putting the regular
folder on a colored background.
folder-bookmarks,
folder-development,
folder-html,
folder-image,
folder-important,
folder-locked,
folder-print,
folder-sound,
folder-tar,
folder-txt,
folder-video -> svn rm
(emulate with folder + emblem overlay)
network-wired -> network-workgroup
network-local -> devices/network-wired
start-here OK
trashcan-empty-alt -> svn rm, or move to alternative/
user-home OK (JRT: However, the house (go-home)
might be a better choice than
the folder and house.)
user-trash OK

* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
it's not really suited to be a standard icon
</pre>

== To do for Oxygen ==

Icons that are in the spec, but not yet in Oxygen's places/ (after renaming) so they need to be added. Descriptions taken from the specification.

<pre>
folder-remote
The icon used for normal directories on a remote filesystem.
(Editor's note: Move from devices/drive-remote for now.)

network-server
The icon used for individual host machines under the
“Network Servers” place in the file manager.
(Editor's note: a computer in a network.)

start-here -- (dmiller: DONE, but left here for generic icon discussion)
The icon used by the desktop's main menu for accessing places,
applications, and other features. (Editor's note: apps/kmenu
should be moved to start-here-kde so that GNOME desktops
with Oxygen icons won't get the KDE icon in their panel.
So could we have a more generic start-here icon for this?)

user-desktop
The icon for the special “Desktop” directory of the user.
</pre>

== To do for Oxygen -- Not in Spec ==

Icons that are not in the spec, and not yet in Oxygen's places/ (after renaming) so they need to be added.

<pre>
</pre>

== Summary of the suggested changes and additions ==

The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.

<pre>
network-workgroup -> network-local
The icon for local networks and workgroups within the network.
(jpetso: hm... is the suggestion still current or should we
simply drop it?)
</pre>

== Stuff that needs to be done in the code ==

* Replace root folder occurrences (folder-red) with drive-harddisk?
(Discuss with kde-usability first.)
* Use folder-remote in remote:/.
(Also discuss with kde-usability.)

User:Djmdave

2007-08-31T20:11:03Z

Djmdave: added some notes / contact details

David Miller

Oxygen Icon Designer

IRC d-miller in #oxygen #kde-artists

Projects/Oxygen/namingSpec/status

2007-08-31T20:06:21Z

Djmdave: davigno did the audio icons

Not yet ready for consumption, this is only the raw list of icons in the spec, without checking on what Oxygen already has.

== Specification compliance of icon names ==

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

<pre>
actions/battery-discharging-020 -> battery-caution
actions/battery-discharging-040 -> battery-low
audio-volume-high OK
audio-volume-low OK
audio-volume-medium OK
audio-volume-muted OK
dialog-error OK
dialog-information OK
dialog-warning OK
actions/folder-open -> folder-open
dialog-password OK
user-trash-full OK

* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
it's not really suited to be a standard icon
</pre>

== To do for Oxygen ==

Icons that are in the spec, but not yet in Oxygen's status/ (after renaming) so they need to be added. Descriptions taken from the specification.

<pre>
appointment-missed
The icon used when an appointment was missed.

appointment-soon
The icon used when an appointment will occur soon.

dialog-question
The icon used when a dialog is opened to ask a simple
question of the user.

folder-drag-accept
The icon used for a folder while an object is being
dragged onto it, that is of a type that the directory
can contain.

folder-visiting
The icon used for folders, while their contents are being
displayed in another window. This icon would typically be used
when using multiple windows to navigate the hierarchy, such as
in Nautilus's spatial mode.

image-loading
The icon used when another image is being loaded, such as
thumnails for larger images in the file manager.

image-missing
The icon used when another image could not be loaded.

mail-attachment
The icon used for an electronic mail that contains attachments.

mail-unread
The icon used for an electronic mail that is unread.

mail-read
The icon used for an electronic mail that is read.

mail-replied
The icon used for an electronic mail that has been replied to.

mail-signed
The icon used for an electronic mail that contains a signature.

mail-signed-verified
The icon used for an electronic mail that contains a signature
which has also been verified by the security system.

media-playlist-repeat
The icon for the repeat mode of a media player.

media-playlist-shuffle
The icon for the shuffle mode of a media player.

network-error
The icon used when an error occurs trying to intialize
the network connection of the computing device. This icon
should be two computers, one in the background, with the
screens of both computers, colored black, and with the
theme's style element for errors, overlayed on top of the icon.

network-idle
The icon used when no data is being transmitted or received,
while the computing device is connected to a network.
This icon should be two computers, one in the background,
with the screens of both computers, colored black.

network-offline
The icon used when the computing device is disconnected
from the network. This icon should be a computer in the
background, with a screen colored black, and the theme's
icon element to show that a device is not accessible,
in the foreground.

network-receive
The icon used when data is being received, while the
computing device is connected to a network. This icon
should be two computers, one in the background,
with its screen colored green, and the screen of
the computer in the foreground, colored black.

network-transmit
The icon used when data is being transmitted, while the
computing device is connected to a network. This icon
should be two computers, one in the background, with its
screen colored black, and the screen of the computer in
the foreground, colored green.

network-transmit-receive
The icon used data is being both transmitted and received
simultaneously, while the computing device is connected
to a network. This icon should be two computers, one in
the background, with the screens of both computers,
colored green.

printer-error
The icon used when an error occurs while attempting to
print. This icon should be the theme's printer device icon,
with the theme's style element for errors, overlayed on top
of the icon.

printer-printing
The icon used while a print job is successfully being
spooled to a printing device. This icon should be the
theme's printer device icon, with a document emerging
from the printing device.

security-high
The icon used to indicate that the security level of a
connection is known to be secure, using strong encryption
and a valid certificate.

security-medium
The icon used to indicate that the security level of a
connection is presumed to be secure, using strong
encryption, and a certificate that could not be
automatically verified, but which the user has chosen
to trust.

security-low
The icon used to indicate that the security level of a
connection is presumed to be insecure, either by using
weak encryption, or by using a certificate that could
not be automatically verified, and which the user has
not chosen to trust.

software-update-available
The icon used when an update is available for software
installed on the computing device, through the system
software update program.

software-update-urgent
The icon used when an urgent update is available
through the system software update program.

sync-error
The icon used when an error occurs while attempting to
synchronize data from the computing device,
to another device.

sync-synchronizing
The icon used while data is successfully synchronizing
to another device.

task-due
The icon used when a task is due soon.

task-passed-due
The icon used when a task that was due,
has been left incomplete.

user-away
The icon used when a user on a chat network is away
from their keyboard and the chat program.

user-idle
The icon used when a user on a chat network has not been
an active participant in any chats on the network,
for an extended period of time.

user-offline
The icon used when a user on a chat network is not available.

user-online
The icon used when a user on a chat network is available
to initiate a conversation with.

weather-clear
The icon used while the weather for a region
is "clear skies".

weather-clear-night
The icon used while the weather for a region
is "clear skies" during the night.

weather-few-clouds
The icon used while the weather for a region
is "partly cloudy".

weather-few-clouds-night
The icon used while the weather for a region
is "partly cloudy" during the night.

weather-fog
The icon used while the weather for a region is "foggy".

weather-overcast
The icon used while the weather for a region is "overcast".

weather-severe-alert
The icon used while a sever weather alert is
in effect for a region.

weather-showers
The icon used while rain showers are occurring in a region.

weather-showers-scattered
The icon used while scattered rain showers are occurring
in a region.

weather-snow
The icon used while snow showers are occurring in a region.

weather-storm
The icon used while storms are occurring in a region.
</pre>

== Summary of the suggested changes and additions ==

The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.

<pre>
battery-charging
The icon used when the battery is charging
from the power supply.
</pre>

Projects/Oxygen/namingSpec/status

2007-08-31T20:03:52Z

Djmdave: /* Specification compliance of icon names */

Not yet ready for consumption, this is only the raw list of icons in the spec, without checking on what Oxygen already has.

== Specification compliance of icon names ==

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

<pre>
actions/battery-discharging-020 -> battery-caution
actions/battery-discharging-040 -> battery-low
dialog-error OK
dialog-information OK
dialog-warning OK
actions/folder-open -> folder-open
dialog-password OK
user-trash-full OK

* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
it's not really suited to be a standard icon
</pre>

== To do for Oxygen ==

Icons that are in the spec, but not yet in Oxygen's status/ (after renaming) so they need to be added. Descriptions taken from the specification.

<pre>
appointment-missed
The icon used when an appointment was missed.

appointment-soon
The icon used when an appointment will occur soon.

audio-volume-high
The icon used to indicate high audio volume.

audio-volume-low
The icon used to indicate low audio volume.

audio-volume-medium
The icon used to indicate medium audio volume.

audio-volume-muted
The icon used to indicate the muted state for audio playback.

dialog-question
The icon used when a dialog is opened to ask a simple
question of the user.

folder-drag-accept
The icon used for a folder while an object is being
dragged onto it, that is of a type that the directory
can contain.

folder-visiting
The icon used for folders, while their contents are being
displayed in another window. This icon would typically be used
when using multiple windows to navigate the hierarchy, such as
in Nautilus's spatial mode.

image-loading
The icon used when another image is being loaded, such as
thumnails for larger images in the file manager.

image-missing
The icon used when another image could not be loaded.

mail-attachment
The icon used for an electronic mail that contains attachments.

mail-unread
The icon used for an electronic mail that is unread.

mail-read
The icon used for an electronic mail that is read.

mail-replied
The icon used for an electronic mail that has been replied to.

mail-signed
The icon used for an electronic mail that contains a signature.

mail-signed-verified
The icon used for an electronic mail that contains a signature
which has also been verified by the security system.

media-playlist-repeat
The icon for the repeat mode of a media player.

media-playlist-shuffle
The icon for the shuffle mode of a media player.

network-error
The icon used when an error occurs trying to intialize
the network connection of the computing device. This icon
should be two computers, one in the background, with the
screens of both computers, colored black, and with the
theme's style element for errors, overlayed on top of the icon.

network-idle
The icon used when no data is being transmitted or received,
while the computing device is connected to a network.
This icon should be two computers, one in the background,
with the screens of both computers, colored black.

network-offline
The icon used when the computing device is disconnected
from the network. This icon should be a computer in the
background, with a screen colored black, and the theme's
icon element to show that a device is not accessible,
in the foreground.

network-receive
The icon used when data is being received, while the
computing device is connected to a network. This icon
should be two computers, one in the background,
with its screen colored green, and the screen of
the computer in the foreground, colored black.

network-transmit
The icon used when data is being transmitted, while the
computing device is connected to a network. This icon
should be two computers, one in the background, with its
screen colored black, and the screen of the computer in
the foreground, colored green.

network-transmit-receive
The icon used data is being both transmitted and received
simultaneously, while the computing device is connected
to a network. This icon should be two computers, one in
the background, with the screens of both computers,
colored green.

printer-error
The icon used when an error occurs while attempting to
print. This icon should be the theme's printer device icon,
with the theme's style element for errors, overlayed on top
of the icon.

printer-printing
The icon used while a print job is successfully being
spooled to a printing device. This icon should be the
theme's printer device icon, with a document emerging
from the printing device.

security-high
The icon used to indicate that the security level of a
connection is known to be secure, using strong encryption
and a valid certificate.

security-medium
The icon used to indicate that the security level of a
connection is presumed to be secure, using strong
encryption, and a certificate that could not be
automatically verified, but which the user has chosen
to trust.

security-low
The icon used to indicate that the security level of a
connection is presumed to be insecure, either by using
weak encryption, or by using a certificate that could
not be automatically verified, and which the user has
not chosen to trust.

software-update-available
The icon used when an update is available for software
installed on the computing device, through the system
software update program.

software-update-urgent
The icon used when an urgent update is available
through the system software update program.

sync-error
The icon used when an error occurs while attempting to
synchronize data from the computing device,
to another device.

sync-synchronizing
The icon used while data is successfully synchronizing
to another device.

task-due
The icon used when a task is due soon.

task-passed-due
The icon used when a task that was due,
has been left incomplete.

user-away
The icon used when a user on a chat network is away
from their keyboard and the chat program.

user-idle
The icon used when a user on a chat network has not been
an active participant in any chats on the network,
for an extended period of time.

user-offline
The icon used when a user on a chat network is not available.

user-online
The icon used when a user on a chat network is available
to initiate a conversation with.

weather-clear
The icon used while the weather for a region
is "clear skies".

weather-clear-night
The icon used while the weather for a region
is "clear skies" during the night.

weather-few-clouds
The icon used while the weather for a region
is "partly cloudy".

weather-few-clouds-night
The icon used while the weather for a region
is "partly cloudy" during the night.

weather-fog
The icon used while the weather for a region is "foggy".

weather-overcast
The icon used while the weather for a region is "overcast".

weather-severe-alert
The icon used while a sever weather alert is
in effect for a region.

weather-showers
The icon used while rain showers are occurring in a region.

weather-showers-scattered
The icon used while scattered rain showers are occurring
in a region.

weather-snow
The icon used while snow showers are occurring in a region.

weather-storm
The icon used while storms are occurring in a region.
</pre>

== Summary of the suggested changes and additions ==

The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.

<pre>
battery-charging
The icon used when the battery is charging
from the power supply.
</pre>

Projects/Oxygen/namingSpec/categories

2007-08-31T19:58:41Z

Djmdave: /* Specification compliance of icon names */

== Specification compliance of icon names ==

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

<pre>
applications-accessories OK
applications-engineering OK
applications-education OK *
applications-games OK
applications-office OK
applications-other OK ***
applications-science OK
applications-system OK
applications-utilities OK
applications-accessories OK
applications-development OK
applications-graphics OK
applications-internet OK
applications-multimedia OK
preferences-desktop-peripherals OK ***
preferences-desktop-personal OK
preferences-system OK
preferences-system-network OK ***
system-help OK

* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
it's not really suited to be a standard icon
*** bad naming in the spec imho, suggesting to rename this icon
there, but let's use the specified name for now
</pre>

== To do for Oxygen ==

Icons that are in the spec, but not yet in Oxygen's categories/ so they need to be added. Descriptions taken from the specification. (A lot of those icons already exist as package_* in apps/, they'd only need to be pulled over to here.)

<pre>
preferences-desktop
The icon for the "Desktop Preferences" category.

preferences-other
The icon for the “Other” preferences category.
</pre>

== Suggested changes and additions ==

Including a suggested short description text like needed for inclusion in the spec.

<pre>
applications-development
[In the description, change "Programming" to "Development",
in accordance to the icon name and the fd.o menu spec.]

applications-education
The icon for the "Education" sub-menu of the Programs menu.

applications-other -> applications
The icon for a general applications category.

preferences-other -> preferences
The icon for a general preferences category.

preferences-desktop-peripherals -> preferences-peripherals
The icon for the "Peripherals" preferences category.

preferences-desktop-personal -> preferences-personal
The icon for the "Personal" preferences category.

preferences-system-network -> preferences-network
The icon for the "Network" preferences category.
</pre>

Rationale for the renames:

"other" implies that the icon should be a generic one, and indeed applications-other and preferences-other make for a good fallback if there are categories not covered by a given theme. Also, at least KDE has no "other preferences" category, but rather a separate system settings application and a menu (with icon), both using one general settings icon for the whole set of sub-elements.

The preferences-desktop-* ones are very implementation specific, as it's not specified anywhere that the "peripherals" and "personal" preferences need to be a child element of the desktop preferences. Likewise, "network" settings don't necessarily reside in the preferences-system category in certain desktops.

Projects/Oxygen/namingSpec/apps

2007-08-31T19:55:26Z

Djmdave: made list up to date after my changes

== Specification compliance of icon names ==

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

'''Generic Application Names (in the spec):'''

<pre>
accessories-calculator OK
accessories-character-map OK
accessories-dictionary OK
help-browser OK
kaddressbook -> office-addressbook **
kcall -> internet-telephony
kmail -> internet-mail **
korganizer -> office-calendar **
ksnapshot -> accessories-screen-shot **
kuickshow -> graphics-viewer-image **
kwallet OK
kwrite -> accessories-text-editor
multimedia-volume-control OK
okular -> graphics-viewer-document **
preferences-desktop-accessibility OK
preferences-desktop-font OK
preferences-desktop-keyboard OK
preferences-desktop-locale OK
preferences-desktop-multimedia Needed
preferences-desktop-screensaver OK
preferences-desktop-sound OK **
preferences-desktop-theme Needed
preferences-desktop-wallpaper OK
preferences-system-windows OK **
system-file-manager OK
system-software-update OK
utilities-system-monitor OK
utilities-terminal OK
ark -> utilities-file-archiver **
</pre>

'''Generic Application Names (not in the spec):'''
<pre>
preferences-desktop-cryptography OK
preferences-desktop-notifications OK
preferences-system-bluetooth OK
preferences-system-time OK
</pre>

'''Generic Tango icons in Oxygen:'''

<pre>
krfb -> preferences-desktop-remote-desktop
</pre>

'''Other application icons:'''

Most other application icons should go to their home modules instead of residing in kdelibs - this not only makes for a better overview but also reduces disk space in case not all modules are installed. And, of course, prevents icons being misused for wrong usages.

<pre>
acroread ?? needs a spec type name for fallback
RFC: "viewer-document-acroread"
basket -> move to wherever basket lives
digikam -> move to extragear/graphics/digikam
gwenview -> move to kdegraphics/gwenview
k3b -> move to extragear/multimedia/k3b
as multimedia-disc-creator-k3b
kaffeine -> move to extragear/kaffeine
as multimedia-player-kaffeine
kalzium -> move to kdeedu/kalzium
kanagram -> move to kdeedu/kanagram
kate -> move to kdesdk/kate as
accessories-text-editor-kate
kblogger -> move to wherever kblogger lives
kbruch -> move to kdeedu/kbruch
kbugbuster -> move to kdesdk/kbugbuster
kchart -> move to koffice/kchart
kcmkwm -> svn rm
kcolorchooser -> move to kdegraphics/kcolorchooser
kdeprint-printer -> svn rm,
we already have devices/printer
KEduca -> keduca (right?), and move to
wherever keduca lives
kexi -> move to koffice/kexi
kfind ?? svn rm,
replaced by actions/system-search
kgeography -> move to kdeedu/kgeography
kget -> move to kdenetwork/kget
khangman -> move to kdeedu/khangman
kiten -> move to kdeedu/kiten
kjournal ?? does it still exist? if no, svn rm.
if yes, move to wherever it lives.
KLatin -> klatin (right?), and move to
wherever klatin lives
klettres -> move to kdeedu/klettres
klipper -> move to kdebase/klipper
kmplayer -> move to extragear/multimedia/kmplayer
as multimedia-player-kmplayer
KmPlot -> kmplot, and move to kdeedu/kmplot
knotes -> move to kdepim/knotes
(and to the notes plasmoid?)
knotify ?? does it still exist? if no, svn rm.
if yes, move to wherever it lives.
kolf -> move to kdegames/kolf
konqueror -> move to kdebase/konqueror as
internet-web-browser-konqueror
kontact -> move to kdepim/kontact
konversation -> move to extragear/network/konversation
konv-message -> move to extragear/network/konversation,
and rename it to konversation-message
kopete -> move to kdenetwork/kopete
KPercentage -> kpercentage, and move to
kdeedu/kpercentage
krita -> move to koffice/krita
kruler -> move to kdegraphics/kruler
ksim-cpu ?? find out which apps use this icon
(or devices/cpu), and make it private
KSniffer -> ksniffer, and move to
playground/network/ksniffer
kstars -> move to kdeedu/kstars
kteatime -> move to kdetoys/kteatime
ktorrent -> move to extragear/network/ktorrent
once the KDE 4 port is finished
KVerbos -> kverbos, and move to
playground/edu/kverbos
KWordQuiz -> kwordquiz, and move to
kdeedu/kwordquiz
kword -> move to koffice/kword
laptop-battery ?? another battery icon? svn rm,
or replace devices/battery
with this one
marble -> move to kdeedu/marble
none -> svn rm
plasmagik -> move to
playground/base/plasma/plasmagik
wine OK
x OK ** [see Discussion]

* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
it's not really suited to be a standard icon
</pre>

== To do for Oxygen ==

Icons that are in the spec, but not yet in Oxygen's apps/ (after renaming) so they need to be added. Descriptions taken from the specification.

<pre>
preferences-desktop-multimedia
The icon used for the desktop's multimedia preferences.

preferences-desktop-theme
The icon used for the desktop's theme preferences.
</pre>

== To do for Oxygen - not in the spec ==

Icons that are not specified and do not currently exist as well, but are needed for KDE applications (and not blatantly obvious). Yes, I am aware that some of those are bad (if not outright evil) names. That comes from preferences-desktop-peripherals being classified in the "desktop" preferences subgroup, which is very wrong imho. We need to fix this in the spec (see the suggestions of the [[Projects/Oxygen/namingSpec/categories|categories]] page), but until then, I stay with specification conform names.

<pre>
preferences-desktop-display
The icon for the "Display" KCM.

preferences-desktop-effects
The icon for the "Desktop Effects; KCM. (New in KDE 4.)

preferences-desktop-gaming
The icon for the "Joystick" KCM.

preferences-desktop-launch-feedback
You can guess. Really, it's easy.

preferences-desktop-mouse
The icon for the "Mouse" KCM.

preferences-desktop-panel
The icon for the "Panels" KCM.

preferences-desktop-user
The icon for the "About me" KCM in KDE 4's System Settings
(which was named "Password & User Account in KDE 3).

preferences-system-login
The icon for the "Login Manager" KCM.

preferences-system-power-management
The icon for the "Power Control" KCM. (Although I'm not sure if
this will still exist for KDE 4, at least in its current form.)

preferences-system-network-share
The icon for the "File Sharing" KCM.

preferences-system-session
The icon for the "Session Manager" KCM.
(This icon also exists in the Tango set.)

preferences-system-splash
The icon for the "Splash Screen" KCM.
</pre>

== Optional icons ==

We don't absolutely need those because they are covered by fallbacks: if these icons don't exist, they've got a sensible fallback.

<pre>
preferences-desktop-display-randr
The icon for the "Size & Orientation" KCM.

preferences-desktop-keyboard-khotkeys
The icon for the "KHotKeys" KCM.

preferences-desktop-panel-taskbar
The icon for the "Taskbar" KCM.

preferences-desktop-user-smartcard
The icon for the "Smartcards" KCM.
(Was "identity" in KDE 3, and is really not necessary.)

preferences-system-solid
The icon for the "Solid" KCM. (New in KDE 4.)

preferences-system-windows-effects
The icon for the "Window Effects" KCM. (New in KDE 4.)

preferences-system-windows-decoration
The icon for the "Window Decorations" KCM.

preferences-system-windows-specific
The icon for the "Window-Specific Settings" KCM.
</pre>

== Icons in Tango, but not in the spec ==

We don't need to have those, but if we do they should be named this way:

<pre>
internet-group-chat
For a possible generic instant messager icon.
*Very* optional though, as we already have branded
Kopete and Konversation icons.

internet-mail
We already have this from the previous "kmail" icon.

internet-news-reader
Instead of "knode".

internet-web-browser
For a possible generic browser icon. *Very* optional though,
as we already have a branded Konqueror icon.

office-calendar
We already have this from the previous "korganizer" icon.

preferences-desktop-assistive-technology
Tango does this as preferences-desktop-accessibility
plus an emblem-style gear icon at the lower right.
Hardly necessary to have.

preferences-desktop-sound
Go Phonon go. (Done.)

preferences-system-network-proxy
We do have proxy settings in KDE 3, this might make sense.

preferences-system-session
The icon for the session management settings.

preferences-system-windows
Done.

system-installer
Adept, Yast, Pirut, Smart, or whatever else is out there.

system-users
Seems to fit KUser or Guidance's "User Management" module.
</pre>

Getting Started/Build/KDE4

2007-08-28T20:41:01Z

Djmdave: /* Kubuntu and Debian (Testing/Unstable) */ cleaner title

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]] [[../KDE4/Windows|Instructions for MS Windows]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. There are also tutorials for [[/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[/Mac OS X|Mac OS X]] and [http://solaris.kde.org/ Solaris]. Throughout the tutorial the bash shell is used.

{{warning|Expect a higher risk of build failure '''on Mondays''' when most kdelibs changes are committed. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Required Software ==

The following must be installed first before you can successfully complete this tutorial:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

=== Ark Linux ===
In Ark Linux, the build dependencies you need are installed with:

<code bash>
apt-get install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

If you prefer a graphical interface, select the packages listed above in the "Install Software" tool in Mission Control.

This includes installation of CMake, DBus and Qt - you can skip steps 5, 6 and 7.

=== Kubuntu and Debian ===

In Kubuntu 7.04 (Feisty) and Debian (Testing/Unstable) the build dependencies you need are installed with:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libgpgme11-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev
</code>

You can skip the manual installation of CMake 2.4.6 and DBus with:
<code bash>
sudo aptitude install libdbus-1-dev cmake
</code>

For a fully functional API documentation framework you also need:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

In openSUSE 10.2 and newer, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Required Packages'''

The packages you will need to install are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the adding the openSUSE Build Service KDE4 Repository to your installation sources.

For openSUSE 10.2 and newer do:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

For older versions of SUSE Linux do:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Now install the following packages (and their dependencies):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

And for fully functional apidox framework you also need:
<code>
graphviz
</code>

CMake binary packages for openSUSE are available from [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

==== Install by hand ====

You can use stable ebuilds just remember to sync your portage before you begin.

Remember: All commands are executed as root.

Required:

We need to allow the following keyword masked ebuilds.

<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Optional:

If you decide not to use the KDE qt-copy, you need to keyword unmask Qt.

<code bash>
echo 'x11-libs/qt' >> /etc/portage/package.keywords
</code>

And now need to mask any Clucene versions above 0.9.16a.

<code bash>
echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

Make sure you have set the berkdb USE flag for redland, otherwise nepomuk won't work.

<code bash>
echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

These are the packages you will need to emerge, I included the update option into the emerge command so you will not re-emerge anything that you might already have installed.

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal'
</code>

You will also need to emerge either 'kde-base/kdesdk' or kde-base/kdesdk-scripts'.

Optional:

If you decided to use Gentoo's version of Qt4, you can emerge it using the following command.

<code bash>
emerge -avu 'x11-libs/qt'
</code>

If you emerged DBUS, CMAKE, QT or HAL you may skip those sections respectively.
Good luck!

==== Install via portage ====

Also you can install the KDE 4 packages directly via
<code bash>
emerge -a <packagename>
</code>

To get the things you need, [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] and then pull in the KDE overlay (which contains experimental KDE ebuilds):
<code bash>
layman -a kde
</code>
After this you need to adjust some USE-flags for KDE 4 and tell portage to use the testing KDE 4 ebuilds instead of the stable KDE 3 ones.

That way portage will do the dependency tracking for you.

Detailed instructions on building KDE 4 in Gentoo via portage can be found in the [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. They are discussed in the thread [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. You will probably also want to modify the path to make sure it doesn't include your kde3 paths. Also if you want to use KDevelop to develop KDE 4 applications you may pass the ''-GKDevelop3'' flag to the ''cmake'' command (to make CMake generate KDevelop project files, it will help to avoid rebuilding in the future, see [[Getting_Started/Set_up_KDE_4_for_development#Setting_up_the_environment|this]]).
To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
su - kde-devel
</code>

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.
On Ark Linux, you can skip this step - {{path|/bin/sh}} is {{path|bash}} on Ark Linux.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade. You probably want to skip building the bindings until/unless you know you will be building HAL (see below).

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 of the following instructions should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure

# if you will be building HAL, you also need the glib bindings
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

The steps for building the glib bindings are similar to the above.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. You should use the copy in the KDE Subversion servers. (note: some distros, like Debian, tend to supply Qt with patches from KDE svn applied, so you may want to cheat and use precompiled Qt from your distro)

=== The Recipe ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# if we don't install, we'll just clear obj files to
# save disk space
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-6). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 7) and install (line 10) Qt. If install dir is the same as the current dir (line 8), then we just free some space (line 9) instead. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. '''Note:''' You may need to run <tt>xhost +local:kde-devel</tt> as your regular kde3 user to run this application. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== HAL ==

{{tip|You can use qdbusviewer to see if you have org.freedesktop.hal. If not, you might need a newer version of hal. If you have org.freedesktop.hal, you probably don't need to, and don't ''want'' to, roll your own HAL.}}

If your system requires you to build a newer version of HAL, there's a decent chance you'll need to build other stuff as well, some of which may not be straight forward. Since this should only be required for older distros, instructions are on [[Getting_Started/Build/HAL| a separate page]].

== kdesupport ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/kde/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== Troubleshooting ===
If you get
cmakekde: command not found
then you have to go manualy into the kdesupport directory in ~ and execute the command cmakekde. if this still doesnt work, then something is wrong with your bashrc.

If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

If you get
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
see [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Using Subversion with KDE]

If you get
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
take a second look in the .bashrc file described above, are paths correct? Alternatively, you may see this error if you decided to use a distribution installed version of qt4 and skipped the Qt install above. Either install qt-copy as describe above, or "sudo make install". If you use "sudo make install", make sure you that you change the ownership back to your user for some of the ~/kde subdirectories that were effected by using sudo (ie. "<tt>sudo chown -R kde-devel:kde-devel ~/kde</tt>").

== kdelibs ==

We can now move on to building KDE's base libraries.

=== The Recipe ===
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/kde/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>) If the message stays, run 'svn status' in the kdelibs directory and remove all files labeled with '?'.
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, remove CMakeCache.txt and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/kde/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

=== Troubleshooting ===
If you have trouble compiling kdepimlibs:
* the cmakekde command may require a later version of the gpgme library. This is available from the project's web site: http://www.gnupg.org/(en)/download/index.html - please note that the build of gpgme also requires libgpg-error, also available from the same location. Both libraries are installed by the "./configure", "make" and "sudo make install" sequence, with the gpgme library configured with the additional "--with-gpg-error-prefix" parameter. You may need to overwrite your existing "/usr/bin/gpgme-config" file with the newer version for the kdepimlibs to pick up the new install.
* if you get the error "cannot find -lpth" from /usr/bin/ld, then make sure you have The GNU Portable Threads (libpth-dev for Debian).

== kdebase ==
kdebase is divided into three parts:
* '''apps'''
:This contains applications like Dolphin or KWrite.
* '''runtime'''
:This contains things needed by every application at runtime, like icons. It is a required dependency for each KDE application, so you have to compile and install this.
* '''workspace'''
:This contains things specific to the KDE desktop, like Plasma or the window manager. Most stuff here depends on X11. You only need it if you want to build a full KDE desktop.

You can build all of kdebase at once, which is described in the recipe below. If you only want to build kdebase-runtime, which is the only requirement, you can replace <code bash>cd kdebase</code> with <code bash>cd kdebase/runtime</code> in the receipe below.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you do not have those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get an error complaining about a missing variable X11_Xrandr_LIB, you need the devel package for libxrandr (libxrandr-devel on ubuntu-systems)
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) ", try editing CMakeCache.txt and setting QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.la

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Another, even easier method involves downloading this [[Doxyfile]] to your local system. Then simply change directory to where you want to create the documentation and run
<code bash>
% doxygen /path/to/Doxyfile
</code>
Then review the file {{path|doxygen.log}} to see the doxygen errors and warnings. You'll find the actual documentation in the {{path|apidocs}} subdirectory.

== Staying up to date ==

In order to keep the kde4 installation up to date, each of the modules installed should be updated periodically. As Monday is the day for big changes in kdelibs, Tuesday may be the best day to do this. For each module checked out, run <tt>svn up</tt> and <tt>make</tt>.

For example:
<code bash>
cs kdesupport # cs is not a typo
svn up
cb # cb is not a typo
make -j2 VERBOSE=1 && make install
</code>

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4

2007-08-28T20:40:21Z

Djmdave: /* Kubuntu */ included debian as well (have tested and this works)

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]] [[../KDE4/Windows|Instructions for MS Windows]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. There are also tutorials for [[/FreeBSD|FreeBSD]], [http://www.kdelibs.com/ Windows], [[/Mac OS X|Mac OS X]] and [http://solaris.kde.org/ Solaris]. Throughout the tutorial the bash shell is used.

{{warning|Expect a higher risk of build failure '''on Mondays''' when most kdelibs changes are committed. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Required Software ==

The following must be installed first before you can successfully complete this tutorial:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

=== Ark Linux ===
In Ark Linux, the build dependencies you need are installed with:

<code bash>
apt-get install devel-core libxml-devel libxslt-devel bzip2-devel \
clucene-devel librdf-devel shared-mime-info xorg-Mesa-libGL-devel \
subversion boost-devel doxygen giflib-devel dbus-devel openssl-devel \
alsa-lib-devel kdesdk-scripts qt4-devel
</code>

If you prefer a graphical interface, select the packages listed above in the "Install Software" tool in Mission Control.

This includes installation of CMake, DBus and Qt - you can skip steps 5, 6 and 7.

=== Kubuntu and Debian (Testing/Unstable) ===

In Kubuntu 7.04 (Feisty) and Debian (Testing/Unstable) the build dependencies you need are installed with:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev libgpgme11-dev libssl-dev libgpgme11-dev \
libasound2-dev kdesdk-scripts libpth-dev
</code>

You can skip the manual installation of CMake 2.4.6 and DBus with:
<code bash>
sudo aptitude install libdbus-1-dev cmake
</code>

For a fully functional API documentation framework you also need:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

In openSUSE 10.2 and newer, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Required Packages'''

The packages you will need to install are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
libredland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the adding the openSUSE Build Service KDE4 Repository to your installation sources.

For openSUSE 10.2 and newer do:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

For older versions of SUSE Linux do:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Now install the following packages (and their dependencies):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

And for fully functional apidox framework you also need:
<code>
graphviz
</code>

CMake binary packages for openSUSE are available from [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

==== Install by hand ====

You can use stable ebuilds just remember to sync your portage before you begin.

Remember: All commands are executed as root.

Required:

We need to allow the following keyword masked ebuilds.

<code bash>
echo 'dev-util/cmake' >> /etc/portage/package.keywords
echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
</code>

Optional:

If you decide not to use the KDE qt-copy, you need to keyword unmask Qt.

<code bash>
echo 'x11-libs/qt' >> /etc/portage/package.keywords
</code>

And now need to mask any Clucene versions above 0.9.16a.

<code bash>
echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

Make sure you have set the berkdb USE flag for redland, otherwise nepomuk won't work.

<code bash>
echo 'dev-libs/redland berkdb' >> /etc/portage/package.use
</code>

These are the packages you will need to emerge, I included the update option into the emerge command so you will not re-emerge anything that you might already have installed.

<code bash>
emerge -avu 'sys-devel/gcc' \
'dev-util/subversion' \
'dev-util/pkgconfig' \
'x11-base/xorg-x11' \
'virtual/glut' \
'media-libs/mesa' \
'media-libs/jpeg' \
'media-libs/libpng' \
'media-libs/giflib' \
'dev-cpp/clucene' \
'dev-util/cppunit' \
'media-libs/liblrdf' \
'dev-libs/libxml2' \
'dev-libs/libxslt' \
'x11-misc/shared-mime-info' \
'dev-libs/boost' \
'dev-util/cmake' \
'dev-libs/redland' \
'sys-apps/dbus' \
'sys-apps/hal'
</code>

You will also need to emerge either 'kde-base/kdesdk' or kde-base/kdesdk-scripts'.

Optional:

If you decided to use Gentoo's version of Qt4, you can emerge it using the following command.

<code bash>
emerge -avu 'x11-libs/qt'
</code>

If you emerged DBUS, CMAKE, QT or HAL you may skip those sections respectively.
Good luck!

==== Install via portage ====

Also you can install the KDE 4 packages directly via
<code bash>
emerge -a <packagename>
</code>

To get the things you need, [http://gentoo-wiki.com/TIP_Overlays#Layman install layman] and then pull in the KDE overlay (which contains experimental KDE ebuilds):
<code bash>
layman -a kde
</code>
After this you need to adjust some USE-flags for KDE 4 and tell portage to use the testing KDE 4 ebuilds instead of the stable KDE 3 ones.

That way portage will do the dependency tracking for you.

Detailed instructions on building KDE 4 in Gentoo via portage can be found in the [http://overlays.gentoo.org/proj/kde/wiki KDE overlay wiki]. They are discussed in the thread [http://forums.gentoo.org/viewtopic-t-530111-postdays-0-postorder-asc-start-0.html KDE 4 monolithic ebuilds].

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. You will probably also want to modify the path to make sure it doesn't include your kde3 paths. Also if you want to use KDevelop to develop KDE 4 applications you may pass the ''-GKDevelop3'' flag to the ''cmake'' command (to make CMake generate KDevelop project files, it will help to avoid rebuilding in the future, see [[Getting_Started/Set_up_KDE_4_for_development#Setting_up_the_environment|this]]).
To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
su - kde-devel
</code>

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.
On Ark Linux, you can skip this step - {{path|/bin/sh}} is {{path|bash}} on Ark Linux.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade. You probably want to skip building the bindings until/unless you know you will be building HAL (see below).

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 of the following instructions should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
sudo make install
sudo dbus-uuidgen --ensure

# if you will be building HAL, you also need the glib bindings
cs # see above
wget http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-0.74.tar.gz
tar -xvzf dbus-glib-0.74.tar.gz
cd dbus-glib-0.74/
./configure --prefix=$DBUSDIR
make
sudo make install

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

The steps for building the glib bindings are similar to the above.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. You should use the copy in the KDE Subversion servers. (note: some distros, like Debian, tend to supply Qt with patches from KDE svn applied, so you may want to cheat and use precompiled Qt from your distro)

=== The Recipe ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -nomake examples -nomake demos
make -j2

# if we don't install, we'll just clear obj files to
# save disk space
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-6). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 7) and install (line 10) Qt. If install dir is the same as the current dir (line 8), then we just free some space (line 9) instead. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. '''Note:''' You may need to run <tt>xhost +local:kde-devel</tt> as your regular kde3 user to run this application. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== HAL ==

{{tip|You can use qdbusviewer to see if you have org.freedesktop.hal. If not, you might need a newer version of hal. If you have org.freedesktop.hal, you probably don't need to, and don't ''want'' to, roll your own HAL.}}

If your system requires you to build a newer version of HAL, there's a decent chance you'll need to build other stuff as well, some of which may not be straight forward. Since this should only be required for older distros, instructions are on [[Getting_Started/Build/HAL| a separate page]].

== kdesupport ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/kde/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== Troubleshooting ===
If you get
cmakekde: command not found
then you have to go manualy into the kdesupport directory in ~ and execute the command cmakekde. if this still doesnt work, then something is wrong with your bashrc.

If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

If you get
Fetching external item into 'kdesupport/admin'
Error validating server certificate for 'https://...'
see [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE Using Subversion with KDE]

If you get
FILE cannot create directory: /usr/lib[64]/qt4/plugins/crypto. Maybe need administrative privileges.
- - -
make: *** [install] Error 255
take a second look in the .bashrc file described above, are paths correct? Alternatively, you may see this error if you decided to use a distribution installed version of qt4 and skipped the Qt install above. Either install qt-copy as describe above, or "sudo make install". If you use "sudo make install", make sure you that you change the ownership back to your user for some of the ~/kde subdirectories that were effected by using sudo (ie. "<tt>sudo chown -R kde-devel:kde-devel ~/kde</tt>").

== kdelibs ==

We can now move on to building KDE's base libraries.

=== The Recipe ===
cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/kde/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/kde/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/kde/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>) If the message stays, run 'svn status' in the kdelibs directory and remove all files labeled with '?'.
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, remove CMakeCache.txt and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/kde/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

=== Troubleshooting ===
If you have trouble compiling kdepimlibs:
* the cmakekde command may require a later version of the gpgme library. This is available from the project's web site: http://www.gnupg.org/(en)/download/index.html - please note that the build of gpgme also requires libgpg-error, also available from the same location. Both libraries are installed by the "./configure", "make" and "sudo make install" sequence, with the gpgme library configured with the additional "--with-gpg-error-prefix" parameter. You may need to overwrite your existing "/usr/bin/gpgme-config" file with the newer version for the kdepimlibs to pick up the new install.
* if you get the error "cannot find -lpth" from /usr/bin/ld, then make sure you have The GNU Portable Threads (libpth-dev for Debian).

== kdebase ==
kdebase is divided into three parts:
* '''apps'''
:This contains applications like Dolphin or KWrite.
* '''runtime'''
:This contains things needed by every application at runtime, like icons. It is a required dependency for each KDE application, so you have to compile and install this.
* '''workspace'''
:This contains things specific to the KDE desktop, like Plasma or the window manager. Most stuff here depends on X11. You only need it if you want to build a full KDE desktop.

You can build all of kdebase at once, which is described in the recipe below. If you only want to build kdebase-runtime, which is the only requirement, you can replace <code bash>cd kdebase</code> with <code bash>cd kdebase/runtime</code> in the receipe below.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you do not have those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get an error complaining about a missing variable X11_Xrandr_LIB, you need the devel package for libxrandr (libxrandr-devel on ubuntu-systems)
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: QT_QTOPENGL_LIBRARY (ADVANCED) ", try editing CMakeCache.txt and setting QT_QTOPENGL_LIBRARY:FILEPATH=/home/kde-devel/qt-copy/lib/libQtOpenGL.la

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Another, even easier method involves downloading this [[Doxyfile]] to your local system. Then simply change directory to where you want to create the documentation and run
<code bash>
% doxygen /path/to/Doxyfile
</code>
Then review the file {{path|doxygen.log}} to see the doxygen errors and warnings. You'll find the actual documentation in the {{path|apidocs}} subdirectory.

== Staying up to date ==

In order to keep the kde4 installation up to date, each of the modules installed should be updated periodically. As Monday is the day for big changes in kdelibs, Tuesday may be the best day to do this. For each module checked out, run <tt>svn up</tt> and <tt>make</tt>.

For example:
<code bash>
cs kdesupport # cs is not a typo
svn up
cb # cb is not a typo
make -j2 VERBOSE=1 && make install
</code>

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/KDE/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4

2007-06-17T11:32:53Z

Djmdave: /* openSUSE */ missed boost-devel

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. Throughout the tutorial the bash shell is used. If you are interested in building KDE on other systems such as Solaris, MacOS or Microsoft Windows, please visit the [[../|Build]] page and see the links at the bottom for the respective operating systems.

{{warning|Expect a higher risk of build failure '''on Mondays''' when critical changes are implemented. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Required Software ==

The following must be installed first before you can successfully complete this tutorial:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

You may also want to have the following installed:
* bash

=== Kubuntu ===

In Kubuntu 7.04 (Feisty) the build dependencies you need are installed with:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev
</code>

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the following packages (and their dependencies). '''Please Note:''' This will not work for Qt for KDE4 after Alpha 1 (Kubuntu feisty contains Qt4.3beta, not Qt4.3 final as required. Skip down to building Qt from svn below):
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

And for fully functional [[apidox]] frame work you also need:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

In openSUSE 10.2 and newer, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Required Packages'''

The packages you will need to install are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
boost-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
redland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the adding the openSUSE Build Service KDE4 Repository to your installation sources.

For openSUSE 10.2 and newer do:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

For older versions of SUSE Linux do:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Now install the following packages (and their dependencies):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

And for fully functional apidox frame work you also need:
<code>
graphviz
</code>

CMake binary packages for openSUSE are available from [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

You can use most stable ebuilds just remember to sync your portage before you begin.

We need to be unmasked and/or kept at a lower version to continue.

<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.keywords
# echo 'dev-util/cmake' >> /etc/portage/package.keywords
# echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

These are the packages you will need to install, some may already be installed so you may skip those by adding the update flag to emerge.

<code bash>
$ emerge -avu ebuild/name
</code>

sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
kde-base/kdesdk-scripts
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
dev-libs/redland

You will start compiling by hand from the [[Getting_Started/Build/KDE4#Strigi|Strigi section]].

Good Luck!

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. You will probably also want to modify the path to make sure it doesn't include your kde3 paths. To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
su - kde-devel
</code>

The rest of this tutorial assumes you are running as the <tt>kde-devel</tt> user.

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade.

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
make install
dbus-uuidgen --ensure

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

=== Troubleshooting ===

If you get the error '''makeobj: command not found''' you are lacking the command <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu(feisty:Qt4.3 beta), openSUSE, Fedora, Gentoo, Debian experimental). You should use the copy in the KDE Subversion servers.

=== The Recipe ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2

# do copy files if the target doesnt match current dir,
# clear obj files to save disk space otherwise
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. '''Note:''' You may need to run <tt>xhost +local:kde-devel</tt> as your regular kde3 user to run this application. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== kdesupport ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== TroubleShooting ===
If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

== kdelibs ==

With Qt4, Strigi, and Soprano built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== The Recipe ===

cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

== kdebase ==
You may need kdebase for some kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you haven't those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4

2007-06-17T11:24:50Z

Djmdave: /* openSUSE */ added optional packages

{{Template:I18n/Language Navigation Bar|Getting_Started/Build/KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. Throughout the tutorial the bash shell is used. If you are interested in building KDE on other systems such as Solaris, MacOS or Microsoft Windows, please visit the [[../|Build]] page and see the links at the bottom for the respective operating systems.

{{warning|Expect a higher risk of build failure '''on Mondays''' when critical changes are implemented. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Required Software ==

The following must be installed first before you can successfully complete this tutorial:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

You may also want to have the following installed:
* bash

=== Kubuntu ===

In Kubuntu 7.04 (Feisty) the build dependencies you need are installed with:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev subversion libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen \
libungif4-dev libdbus-1-dev
</code>

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the following packages (and their dependencies). '''Please Note:''' This will not work for Qt for KDE4 after Alpha 1 (Kubuntu feisty contains Qt4.3beta, not Qt4.3 final as required. Skip down to building Qt from svn below):
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

And for fully functional [[apidox]] frame work you also need:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

In openSUSE 10.2 and newer, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
su
yast -i <packagename>
</code>

'''Required Packages'''

The packages you will need to install are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
redland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

'''Optional Packages'''

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the adding the openSUSE Build Service KDE4 Repository to your installation sources.

For openSUSE 10.2 and newer do:
<code>
sudo zypper service-add http://software.opensuse.org/download/KDE:/KDE4/openSUSE_10.2 KDE4-102
</code>

For older versions of SUSE Linux do:
<code>
su
installation_sources -a http://software.opensuse.org/download/KDE:/KDE4/[YOUR SUSE LINUX VERSION]
</code>

Now install the following packages (and their dependencies):
<code>
cmake
dbus-1-devel
libqt4-devel
</code>

And for fully functional apidox frame work you also need:
<code>
graphviz
</code>

CMake binary packages for openSUSE are available from [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

You can use most stable ebuilds just remember to sync your portage before you begin.

We need to be unmasked and/or kept at a lower version to continue.

<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.keywords
# echo 'dev-util/cmake' >> /etc/portage/package.keywords
# echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

These are the packages you will need to install, some may already be installed so you may skip those by adding the update flag to emerge.

<code bash>
$ emerge -avu ebuild/name
</code>

sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
kde-base/kdesdk-scripts
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
dev-libs/redland

You will start compiling by hand from the [[Getting_Started/Build/KDE4#Strigi|Strigi section]].

Good Luck!

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. You will probably also want to modify the path to make sure it doesn't include your kde3 paths. To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
su - kde-devel
</code>

The rest of this tutorial assumes you are running as the <tt>kde-devel</tt> user.

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade.

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=/var
make
make install
dbus-uuidgen --ensure

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

=== Troubleshooting ===

If you get the error '''makeobj: command not found''' you are lacking the command <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar -zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu(feisty:Qt4.3 beta), openSUSE, Fedora, Gentoo, Debian experimental). You should use the copy in the KDE Subversion servers.

=== The Recipe ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2

# do copy files if the target doesnt match current dir,
# clear obj files to save disk space otherwise
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. '''Note:''' You may need to run <tt>xhost +local:kde-devel</tt> as your regular kde3 user to run this application. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== kdesupport ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

There are several libraries that KDE applications rely on in the kdesupport module. This includes Strigi and Soprano for file metadata and search, eigen for visual effects in applications such as Kalzium, taglib for music players and qca for some cryptographic needs.

Strigi itself has a few dependencies as well: you will need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/
cd kdesupport
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources in kdesupport using subversion (line 2), go into the new {{path|~/src/kdesupport}} directory (line 3), and commence the build (line 4). This will leave us in the kdesupport build directory after the build is completed.

=== TroubleShooting ===
If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.
(Gentoo users: The ebuild for librdf is named dev-libs/redland)

== kdelibs ==

With Qt4, Strigi, and Soprano built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== The Recipe ===

cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

== kdebase ==
You may need kdebase for some kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you haven't those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired. 
cd <module home>
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]

Getting Started/Build/KDE4

2007-06-08T09:10:54Z

Djmdave: /* openSUSE */ whoops, missed redland-devel :-)

{{Template:I18n_Getting_Started_Build_KDE4}}

{{TutorialBrowser|

series=Getting Started|

name=Building KDE4 From Source|

pre=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]|

next=[[../../Set_up_KDE_4_for_development|Set up KDE 4 for development]]|

reading=[http://kdesvn-build.kde.org/ kdesvn-build: The KDE From Subversion Build Tool] [[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]] [[Development/Tutorials/CMake |Introduction to CMake]] [[../KDE4/FreeBSD|FreeBSD notes]] [[../KDE4/Mac OS X|Instructions for Mac OS X]]|
}}

== Abstract ==

This tutorial shows one way to get KDE from trunk running on Linux/BSD systems. Throughout the tutorial the bash shell is used. If you are interested in building KDE on other systems such as Solaris, MacOS or Microsoft Windows, please visit the [[../|Build]] page and see the links at the bottom for the respective operating systems.

{{warning|Expect a higher risk of build failure '''on Mondays''' when critical changes are implemented. [http://developer.kde.org/~dirk/dashboard/ Dashboard] reports unexpected breakages. You are encouraged to fix failing modules.
}}

== Required Software ==

The following must be installed first before you can successfully complete this tutorial:
* gcc and g++ from the gcc project, preferably version 4.1 or higher
* svn, the subversion revision control client
* pkg-config
* development libraries and headers for X11, OpenGL (mesa-common-dev and libglu1-mesa-dev), libjpeg, libpng, libungif, [http://clucene.sourceforge.net/index.php/Downloads libclucene], [http://download.librdf.org/source/ librdf], libxml2 and libxslt
* the <tt>makeobj</tt> script, which is part of kdesdk. You can install it as part of kdesdk (kdesdk-scripts on Debian) or similar package, or just download it itself from [http://websvn.kde.org/*checkout*/trunk/KDE/kdesdk/scripts/makeobj WebSVN]
* the [http://freedesktop.org/wiki/Software/shared-mime-info shared-mime-info package], which is the freedesktop MIME standard KDE is using now
* [http://boost.org/ boost], needed by kdebase; after compiling and/or installing boost, in order to make cmake aware about its location (FindBoost), add boost directory (the one containing include subdirectory) to CMAKE_INCLUDE_PATH or set an environment variable called BOOST_ROOT pointing to boost directory.

You may also want to have the following installed:
* bash

=== Kubuntu ===

In Kubuntu 7.04 (Feisty) the build dependencies you need are installed with:
<code bash>
sudo aptitude install build-essential cdbs debhelper cmake libungif4-dev \
libxml2-dev libxslt1-dev libbz2-dev libclucene-dev librdf-dev \
shared-mime-info libgl1-mesa-dev libglu1-mesa-dev mesa-common-dev \
libxext-dev libjpeg-dev libpng-dev libsm-dev libxinerama-dev \
libxrender-dev libfontconfig-dev libboost-dev libxcursor-dev doxygen
</code>

You can skip the manual installation of Qt 4.3, CMake 2.4.6 and DBus by installing the following packages (and their dependencies). '''Please Note:''' This will not work for Qt for KDE4 after Alpha 1:
<code bash>
sudo aptitude install libqt4-dev-kdecopy libdbus-1-dev cmake
</code>

And for fully functional [[apidox]] frame work you also need:
<code bash>
sudo aptitude install graphviz
</code>

=== openSUSE ===

In openSUSE, you can install packages using [http://en.opensuse.org/Zypper Zypper]:
<code bash>
sudo zypper install <package-name>
</code>

In older releases of SUSE, you can use YaST:
<code bash>
yast2 -i <packagename>
</code>

The packages you will need are:
<code>
xorg-x11-devel
libxml2-devel
kdesdk3
clucene-core-devel
libjpeg-devel
liblrdf-devel
libpng-devel
libxslt-devel
redland-devel
Mesa-devel
giflib-devel
subversion
gcc
gcc-c++
</code>

CMake binary packages for openSUSE are available from [http://software.opensuse.org/download/devel:/tools:/building/ openSUSE build service].

=== Gentoo ===

You can use most stable ebuilds just remember to sync your portage before you begin.

We need to be unmasked and/or kept at a lower version to continue.

<code bash>
# echo 'x11-libs/qt' >> /etc/portage/package.keywords
# echo 'dev-util/cmake' >> /etc/portage/package.keywords
# echo 'dev-cpp/clucene' >> /etc/portage/package.keywords
# echo '>dev-cpp/clucene-0.9.16a' >> /etc/portage/package.mask
</code>

These are the packages you will need to install, some may already be installed so you may skip those by adding the update flag to emerge.

<code bash>
$ emerge -avu ebuild/name
</code>

sys-devel/gcc
dev-util/subversion
dev-util/pkgconfig
x11-base/xorg-x11
media-libs/glut
media-libs/mesa
media-libs/jpeg
media-libs/libpng
media-libs/giflib
dev-cpp/clucene
dev-util/cppunit
media-libs/liblrdf
dev-libs/libxml2
dev-libs/libxslt
x11-misc/shared-mime-info
dev-libs/boost
x11-libs/qt
dev-util/cmake
sys-apps/dbus
redland

You will start compiling by hand from the [[Getting_Started/Build/KDE4#Strigi|Strigi section]].

Good Luck!

== Create a user account for KDE4 development ==

{{Note|
Some people like to have a separate user account for KDE 4 (for instance an old bug deleted files by mistake), and the instructions below were written with that approach.

However it is much more efficient to do everything with a single user account, see [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]
for more details.

You can still follow the instructions below, but don't put the environment variables in your <tt>.bashrc</tt>, put them in a separate file that you source to switch to the KDE 4 environment.
}}

=== Option 1: Command Line ===
<code bash>
useradd -m kde-devel
passwd kde-devel
</code>

=== Option 2: Using KControl ===

Instead of using the commands above, you can also use the User module in the KDE Control Center if you already have KDE3 installed.

=== Setting up the environment ===

Copy the {{path|~/.bashrc}} from your normal user account to the new kde-devel account. Next, copy and paste the contents of the [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|example .bashrc]] into {{path|~kde-devel/.bashrc}}. Be sure to comment out the line <tt>alias make=makeobj</tt> if you do not have the <tt>[[Getting Started/Build/KDE4#Required Software|makeobj]]</tt> command available. To make it run, you have to open a new bash or to execute
<code bash>
source ~/.bashrc
</code>

This will provide access to commands such as <tt>cmakekde</tt> that are used in this tutorial as well as ensure that the proper paths are in place for Qt, KDE and CMake binaries.

For more information, please read the [[Getting Started/Increased Productivity in KDE4 with Scripts]] tutorial.

=== Switching to the New User ===
Switch to the user kde-devel: (don't forget the dash)
<code bash>
su - kde-devel
</code>

The rest of this tutorial assumes you are running as the <tt>kde-devel</tt> user.

== The development user's shell ==

On some systems a new user is configured by default to use {{path|/bin/sh}}. If this is not the case on your system, you can skip this section. Using {{path|/bin/sh}} can be very inconvenient to work with and you may want to change it to {{path|/bin/bash}} or another shell.

=== Option 1: As the kde-devel user ===

If you don't have root privileges and your system supports the changing of your own shell with the <tt>chsh</tt> application, then you could try to change your shell to {{path|/bin/bash}} by using:
<code bash>
chsh -s /bin/bash kde-devel
</code>

=== Option 2: As the root user ===

If your system comes with the <tt>usermod</tt> application you can run the following command as root: <tt>usermod -s /bin/bash</tt>.

Another option is to use the <tt>vipw</tt> application as root to safely edit your {{path|/etc/passwd}}. Locate 'kde-devel' in the the file. Change '{{path|/bin/sh}}' at the end of the line to read '{{path|/bin/bash}}', save your changes and exit.

The new shell will be started automatically when you log in as the kde-devel user again.

== D-Bus ==
QtDBus and KDE are known to work with D-Bus versions 0.62, as well as 0.92 and upwards. Versions 0.60 and 0.61 may work too but are not tested. Versions 0.90 and 0.91 are known not to work. We recommend using post-1.0 release versions (at least 0.94), so consider upgrading if you haven't done so.

You may skip this section if you have a recent D-Bus version or if you don't want to upgrade.

Before running these steps in the recipe, make sure your X11 headers and libraries are available. The configure script run on line 5 should output:
Building X11 code: yes

=== The Recipe ===

{{tip|Make sure you did set up your environment correctly as described [[Getting_Started/Build/KDE4#Setting_up_the_environment|above]]. This is necessary for the <tt>cs</tt> and <tt>cb</tt> functions to work.}}

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click here to learn more]]
wget http://dbus.freedesktop.org/releases/dbus/dbus-1.0.2.tar.gz
tar -xvzf dbus-1.0.2.tar.gz
cd dbus-1.0.2/
./configure --prefix=$DBUSDIR --localstatedir=$KDEDIR/var
make
make install
dbus-uuidgen --ensure

=== What's Happening ===
After changing into the source directory (line 1), D-Bus source code is downloaded from freedesktop.org (line 2) and unpacked (line 3). After going into the newly created D-Bus directory (line 4), the build is set up using the supplied {{path|configure}} script (line 5). After building (line 6) and installing (line 7) D-Bus, we use the <tt>dbus-uuidgen</tt> tool to install a machine identification file that allows the bus to start automatically when the desktop session starts (line 8).

Note that you need write access to {{path|/var}} for the last two steps. If your system does not have the sudo command, you can use the <tt>su</tt> command instead, e.g. <tt>su -c "make install"</tt>.

=== Troubleshooting ===

If you get the error '''makeobj: command not found''' you are lacking the command <tt>[[Getting_Started/Build/KDE4#Required_Software|makeobj]]</tt>.

== CMake ==
Skip this if you have [http://cmake.org/ CMake] >=2.4.5 installed.
You should be able to directly use the binary packages available on the [http://www.cmake.org/HTML/Download.html CMake site]. There are also distribution specific packages available.

=== The Recipe ===


cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|'cs' is a bash function, click Here to learn more]]
wget http://www.cmake.org/files/v2.4/cmake-2.4.6.tar.gz
tar zxf cmake-2.4.6.tar.gz
mkdir cmake-build
cd cmake-build
../cmake-2.4.6/bootstrap
make
sudo make install

=== What's Happening ===
First, we go back to the <tt>kde-devel</tt> user's source directory (line 1), get the CMake sources (line 2) and unpack them (line 3). We create a directory to build CMake in (line 4) and go into it (line 5). We then run the CMake bootstrap script to set up the CMake build (line 6), then make (line 7) and install it (line 8) using the root user.

If your system does not have the <tt>sudo</tt> command, you can instead do <tt>su -c "make install"</tt>.

== Qt ==
Next we need to get the Qt4 that is in KDE's source repository. KDE is guaranteed to build against any Qt 4.3. Qt 4.2 and earlier are not supported and will not work. Qt 4.3 has been released only recently, so your distribution probably doesn't have packages for it yet (known exceptions: Kubuntu, openSUSE, Gentoo). You should use the copy in the KDE Subversion servers.

=== The Recipe ===
cd
svn checkout svn://anonsvn.kde.org/home/kde/trunk/qt-copy
cd qt-copy
./apply_patches
./configure -qt-gif -no-exceptions -debug -fast \
-prefix $QTDIR -qdbus -pch -nomake examples \
-nomake demos
make -j2

# do copy files if the target doesnt match current dir,
# clear obj files to save disk space otherwise
if [ $QTDIR = `pwd` ]; then \
find . -name '*.o' -exec rm {} \; ; \
else make install; fi;

=== What's Happening ===
We switch back to the <tt>kde-devel</tt> user's home directory (line 1) and download the source code using subversion (svn) from KDE's repository (line 2). After changing into the resulting {{path|qt-copy}} directory (line 3), we run a script that manages the patches that come with <tt>qt-copy</tt> (line 4).

Once the patches have been applied, we then set up the build using the <tt>configure</tt> script (line 5-7). The various command line options used are explained in the {{path|qt-copy/README.qt-copy}} file. Finally, we build the minimal requirements for KDE (line 8) and install (line 9-10) Qt. If you want all the example and demo applications, you can either build them individually or simply do a <tt>make</tt> from the {{path|qt-copy}} directory.

Note that the installation does not require root as it installs Qt locally into {{path|$QTDIR}}. Anyway, installation is only needed if {{path|$QTDIR}} differs from {{path|$HOME/qt-copy}}, which is not the case if you have exactly followed the instructions.

=== Troubleshooting ===
If you get "error: X11/Xlib.h: No such file or directory", install the devel package of <tt>xorg</tt> (the actual name may vary between operating systems, for example it is <tt>xorg-dev</tt> on Ubuntu based systems such as Kubuntu).

If you get an error in the configure step about missing defines, check the value of <tt>$QMAKESPEC</tt>. Some distributions set this to point directly to the system-installed Qt. If <tt>unset QMAKESPEC</tt> solves the problem, you probably want to add it to the <tt>~/.bashrc</tt> script.

If you get an error ".pch/debug-shared/QtCore", this is because Qt-4.3 enables precompiled headers if your gcc supports it, but for some reason it doesn't work for you. If you use distcc, configure qt with -no-pch. If you use icecream, update to the latest icecream from svn trunk.

Try running any Qt program, like {{program|assistant}}. If it crashes in QSpanData::adjustSpanMethods, then your problem is the oxygen style. Try removing {{path|lib/kde4/plugins/styles/kstyle-oxygen.so}} and {{path|lib/kde4/plugins/styles/oxygen.so}} if they exist in the KDE install prefix.

== Strigi ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

The code for getting file metadata now relies on Strigi. To install Strigi you need the libraries and headers for libz, libbz2, openssl (libcrypto or libssl), libclucene (=0.9.16; version 0.9.17 does '''not''' work), and either libxml2 or libexpat.

=== The Recipe ===

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/strigi
cd strigi
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources for Strigi using subversion (line 2), go into the new {{path|~/src/strigi}} directory (line 3), and commence the build (line 4). This will leave us in the strigi build directory after the build is completed.

==== TroubleShooting ====
If you get
CMake Error: This project requires some variables to be set,
and cmake can not find them.
Please set the following variables:
LIBXML2_INCLUDE_DIR (ADVANCED)
you should install the development package for libxml2.

== Soprano ==

{{warning|If you have jumped to this section without reading [[Getting_Started/Build/KDE4#Setting_up_the_environment|Setting Up The Environment]], '''the recipes provided will not work'''.

The recipes are not in error; <tt>cs</tt> and <tt>cb</tt> are not typos. Your environment '''needs''' to be set up correctly for these instructions to work for you.}}

The code for getting file kmetadata relies on Soprano. To install Soprano you need the libraries and headers for librdf.

=== The Recipe ===
cd $KDE_SRC
svn checkout svn://anonsvn.kde.org/home/kde/trunk/kdesupport/soprano
cd soprano
cmakekde

=== What's Happening ===
We change to the base source directory (line 1). We download the sources for Soprano using subversion (line 2), go into the new {{path|~/src/soprano}} directory (line 3), and commence the build (line 4). This will leave us in the soprano build directory after the build is completed.

==== TroubleShooting ====
If you get
CMake Error: Could NOT find REDLAND
then you need librdf from the Redland.
If your distribution does not provide the librdf package, you can download the source there: [http://download.librdf.org/source/ http://download.librdf.org/source/] and build it.

== kdelibs ==

With Qt4, Strigi, and Soprano built, we can now move on to building KDE's base libraries. If you use the aforementioned [[Getting Started/Increased Productivity in KDE4 with Scripts/.bashrc|.bashrc]] this is where those new functions come in handy.

=== The Recipe ===

cd $KDE_SRC
mkdir KDE && cd KDE
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
cd kdelibs
cmakekde

=== What's Happening ===
We change to the base source directory (line 1) then make and go into the KDE directory (line 2). We download the sources for kdelibs using subversion (line 3), go into the new {{path|~/src/KDE/kdelibs}} directory (line 4), and commence the build (line 5). This will leave us in the <tt>kdelibs</tt> build directory after the build is completed.

{{tip|There might be missing dependencies on your system! They are easily overlooked in the output of <tt>cmakekde</tt>.
You might want to do a <tt>cmake $KDE_SRC/KDE/MODULE_NAME</tt> prior to compiling any kde modules (like kdelibs, kdepimlibs etc.)}}

=== Additional KDE-specific CMake modules ===
There are additional CMake modules in {{path|kdelibs/cmake/modules/}} that are necessary for building KDE4 applications. These will be installed for you when kdelibs itself is installed.

=== Troubleshooting ===
If you have problems compiling kdelibs, first make sure the software in the [[Getting_Started/Build/KDE4#Required_Software|Required Software]] section above is installed and works. Other possible hints include:
* If the <tt>cmakekde</tt> command fails stating that CMake requires an out of source build directory, remove {{path|~/src/KDE/kdelibs/CMakeCache.txt}}, and try again.

If <tt>cmakekde</tt> still gives the same error then try this
cd
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR \
-DCMAKE_BUILD_TYPE=debugfull \
-DKDE4_BUILD_TESTS=ON \
~/src/KDE/kdelibs
make
make install
* If you received an error stating "Please create a separate build directory and run 'cmake path_to_kdelibs [options]' there.", then you need to change to your build directory before running cmakekde. (e.g <tt>cs KDE/kdelibs && cb && cmakekde</tt>)
* If Qt wasn't found or the wrong version of Qt was found, make sure that the qmake from the Qt you need is the first qmake in the path.
* If the problems persist, try the CMake make-option <tt>--keep-going</tt>.
* Here you need the libungif library, otherwise you will get an error message like "<tt>Could NOT find GIF</tt>".
* Qt-4.3 upgrade: if you get a link error in kjsembed talking about QScriptEngine, edit CMakeCache.txt in kdelibs and remove the lines that talk about QT_QTUITOOLS_LIBRARY, then type make again (that static library has a new dependency, and the cmake code that adds it needs to run).
* if you get <code>CMake Error: KDE Requires Qt to be built with SSL support
</code>, install openssl-devel, and re-compile QT.
* if you get <code>kdelibs/kimgio/ico.cpp:188: undefined reference to `QImage::jumpTable()'</code> it means you compiled QT without QT3 support(no, linking to a true QT3 install won't work)

== kdepimlibs ==
After <tt>kdelibs</tt>, but before ''kdebase'', you need to build and install ''kdepimlibs''.

=== The Recipe ===

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepimlibs
cd kdepimlibs
cmakekde

=== What's Happening ===
We go into the KDE source directory (line 1), download the source code for kdepimlibs using subversion (line 2) and then go into the new {{path|~/src/KDE/kdepimlibs}} directory (line 3). We then commence the build (line 4). This will leave us in the <tt>kdepimlibs</tt> build directory after the build is completed.

== kdebase ==
You may need kdebase for some kioslaves.

cs KDE # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
svn checkout svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase
cd kdebase
cmakekde

=== Troubleshooting ===
If you have troubles compiling kdebase:
* Make sure you have the <tt>libxss headers</tt> installed. (Usually you got undefined references on xscreensaver objects if you haven't those headers)
* <tt>which meinproc</tt> has to deliver {{path|/home/kde-devel/kde/bin/meinproc}}
* if cmakekde can not find the path of kdepimlibs, edit the file {{path|$KDE_BUILD/KDE/kdebase/CMakeCache.txt}} and manually set <tt>KDEPIMLIBS_INCLUDE_DIR:PATH=$KDE_BUILD/kdepimlibs</tt>
* if you get an error saying "Please set the following variables: X11_XTest_LIB (ADVANCED)", install the devel package of <tt>Xtst</tt>. On some systems, this is packaged separately from <tt>xext</tt> and called <tt>x11proto-xext-dev</tt> or <tt>libxtst-dev</tt>. You may also need to remove the CMakeCache.txt file in the build dir after installing the package.
* the same for "X11_Xinerama_LIB (ADVANCED)" where you will need the devel package for <tt>xinerama</tt>.
* if you get the error "Please set the following variables: FONTCONFIG_INCLUDE_DIR, FONTCONFIG_LIBRARIES (ADVANCED)", then you need to install the libfontconfig headers
* if you get the error "CMake Error: This project requires some variables to be set, and cmake can not find them. Please set the following variables: KMETADATA_LIBRARIES", you need to install soprano from kdesupport and to rebuild kdelibs
* if you get the error "‘XserverRegion’ does not name a type" make sure you have libxcomposite headers installed (<tt>libxcomposite-dev</tt> in ubuntu)

== Generating local API documentation ==
Although the API documentation for KDE is available online at [http://api.kde.org api.kde.org], it is sometimes useful to have it on your own disk, for example when you want to use [[Getting_Started/Set_up_KDE_4_for_development#KDevelop|KDevelop]] for browsing the documentation or when you are not able to be online all the time.

Be aware that generating the API documentation can take several hours and takes almost half a gigabyte of diskspace.
The generation is handled by a script in {{path|kdelibs/doc/api}}, you need <tt>doxygen</tt> to be able to run it.

To build the API documentation for kdelibs, type the following:

cs KDE/kdelibs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
$KDE_SRC/KDE/kdelibs/doc/api/doxygen.sh \
--doxdatadir=$KDE_SRC/KDE/kdelibs/doc/common .

Repeat for other modules as desired.

== General troubleshooting ==

What can happen over time, after some <tt>svn up</tt> commands, is that some of the tools used in the KDE build chain change their output format. For example, <tt>kcfg</tt> files are read by <tt>kconfig_compiler</tt> to produce configuration dialogs. CMake cannot detect those changes, and the compilation might fail. A workaround is to always force a re-generation of all such files:
find $KDE_SRC/kde/kdebase -name "*.kcfg" | xargs touch
The same applies to <tt>ui</tt> files as produced by Qt designer.

== Success! ==

You are now ready to start building other svn modules in the same fashion as you built kdebase, running and testing KDE4 or writing your own patches and applications.

See the [[Getting Started/Set up KDE 4 for development|Set up KDE 4 for development]] tutorial for how to start KDE 4 applications and how to use KDevelop to work on them.

[[Category:Build KDE]]
[[Category:KDE4]]