oxygen-transparent

Source (link to git-repo or to original if based on someone elses unmodified work): Add the source-code for this project on opencode.net

Description:

Oxygen style and decoration with support for transparency (see screenshots).

This is an official branch of the KDE oxygen style. It is kept in sync with the official oxygen style, and adds support of full transparency on the windows.

The style and the decoration are named "Oxygen Transparent" and appear as such in KDE's system settings (in both the applications and workspace appearance pages).

A configuration helper application is included with the style that allows one to configure both the style and the decoration in the same window. It is called oxygen-transparent-settings.

The provided script, named oxygen-setup.pl is used to:

- get the sources (from git)
- configure them
- compile and install the window decoration and widget style.

important notes

1/ The style (and decoration) should work for recent enough versions of KDE4.

Different versions (branches) must be used depending on your KDE version:

- the KDE/4.8 version works with KDE/4.8 (tested), and possibly some earlier verions (not tested)

- the KDE/4.9 version works with KDE/4.9 (tested)

- the master version works with latest KDE, compiled from git. It may not work with any earlier KDE release.

New versions will be added (KDE/4.10, etc.) when the corresponding KDE4 version is out.

One can switch between branches by running the script and specifying the relevant branch:

[quote]oxygen-setup.pl --branch KDE/4.8
oxygen-setup.pl --branch KDE/4.9
oxygen-setup.pl --branch master[/quote]

By default (when no branch is specified), the master branch is used.

There is a number of additional options available for the setup script. To get a list of them, type:
[quote]./oxygen-setup.pl --help[/quote]

2/ Since March 4th 2011, oxygen-transparent has moved to git.

The project home page is:

https://projects.kde.org/projects/playground/artwork/oxygen-transparent

You can get the sources directly using:

[quote]git clone git://anongit.kde.org/oxygen-transparent[/quote]

3/ KDE development packages are needed for the compilation to succeed (see below)

Feedback highly appreciated either here on on IRC, #oxygen. (ping hpereira, or hugo)

Downloads

There are automatic builds linked in the download section which have been provided by others (thanks !).

Only the first download (the script) is maintained by me, it always provide the latest svn version of the code.

Needed packages for installation/compilation

(thanks to MezzeForte for providing the list):

- gcc-c++
- git
- cmake
- kdebase-workspace-dev
- libxrender-dev
- libx11-dev

- Depending on the distribution you have the name of the packages might change a bit

- there are usually more packages needed by the packages above and installed via dependency.

For instance,

[quote]sudo apt-get install build-essential cmake kdelibs5-dev kdebase-workspace-dev libxrender-dev libx11-dev git[/quote]

should work on recent enough Ubuntu (thanks to Antelmo for posting. See page5).

Bugs:

Even though oxygen-transparent is not officially part of KDE you can report bugs to https://bugs.kde.org.
You would need to select Oxygen as a product, and Style as a component.

Make sure that "Oxygen-Transparent" appears in the bug title so that it does not get confused with official oxygen bugs.

Posting bug reports at bugs.kde.org is highly recommended rather than posting comments on this page, as it makes my life much easier at bookkeeping.

Last changelog:

7 years ago

7f0a6013:
- synchronized with latest oxygen
- created KDE/4.10 branch
- Warning: if you are using the "master" branch (which targets KDE/4.11), you will have conflicts with oxygen (@KDE) configuration, unless you are also using kde from git repositories
This is due to backward incompatible changes in the configuration code.

83a46b6c:
- attempt at fixing bug concerning window positionning on screen for multi-screen setup
- changes in version policy. New available branches are KDE/4.8, KDE/4.9, and master. KDE/4.10 branch will be added as soon as the corresponding KDE4 version is released. The "stable" branch has been removed.

731ce67e:
- synchronized with oxygen (KDE/4.9)
- fixed crash at exit for virtually all KDE applications

d7bb65f0:
- synchronized with oxygen
- use icon from icon theme for tab-close button
- updated install script to deal with master and stable branch

7a121e2:
- synchronized with oxygen
- fixed compilation issues with too old versions of KDE

546 comments

1

2

3

4

5
6

7

8

9

10

Comments/Ratings

Please login or register to add a comment or rating

LaysanA
8 years ago

Oh, also...

I don't know if this matters to you (or anyone else, for that matter), but in your dependency request for ubuntu (kubuntu) above:

Quote:sudo apt-get install build-essential cmake kdelibs5-dev kdebase-workspace-dev libxrender-dev libx11-dev git

Git was not available in apt. I had to go into synaptic and search, where I found kgit, instead.

Report

antelmo
8 years ago

My Bad Forget is git-core, so in kubuntu it should be

sudo apt-get install build-essential cmake kdelibs5-dev kdebase-workspace-dev libxrender-dev libx11-dev git-core

Report

Goden
8 years ago

It's so frustrating something that I want installed on my KDE so badly is also so monumentally difficult to install for someone that is not familiar with Linux. (Getting unexplained errors every step of the way also does not help). I've followed multiple tutorials on how to get this installed and none of them explain enough to actually get me anywhere. Most did not even explain that I actually had to get git and cmake myself.

Report

J0nas
8 years ago

I'm no tech savvy myself but this ppa/deb helps.

(thanks Rog)

https://launchpad.net/~samrog131/+archive/ppa/+build/2221633

Report

HugoPereira
8 years ago

Well, sorry to hear about the frustration.

Oxygen-transparent is definitely experimental and targets somewhat experimented users.

One of the reasons is notably that the code in question is not 100% robust, and that encountered problems might frustrate un-experienced user even more than the frustration they got while trying to install.

Some day, there will be properly released oxygen-transparent code, that linux distributions should be able to ship, and that would make your life easier.

This requires some serious issues to be fixed first. In the meanwhile, sorry, there is not much I can do to ease your frustration.

(note however, that everything you learned while going through the tutorials is not wasted, and you are less an unexperienced user today, than you were before trying to compile and use oxygen-transparent).

Report

alan326
8 years ago

I run kubuntu 11.10 on my eeepc asus 1015 (2gb ram and 320hhd), compositing and all effects on.
Being a newbi, I was wondering if there was a step-by-step tutorial on how to successfully install oxygen-transparent theme.
I'd appreciate your help.
cheers

Report

ThermalGrease
8 years ago

Updated to new version and now I have transparent videos in SMplayer, ghostly :)

VLC works nice, will test some more and see if I can find myself a proper place to file a bug.

Report

HugoPereira
8 years ago

for smplayer, you might need to re-update your "exceptions" (in oxygen-transparent-settings" - background opacity - exceptions button)

for filing bug reports:

https://bugs.kde.org
select Oxygen as a product; widget style as component, and be sure to mention oxygen-transparent in the bug title.

Thanks !

Report

whererun
8 years ago

[[email protected] ~]$ oxygen-transparent-settings
QSharedPointer: pointer 0x1dc1f60 already has reference counting
KCrash: Application 'oxygen-transparent-settings' crashing...
KCrash: Attempting to start /usr/libexec/kde4/drkonqi from kdeinit
sock_file=/home/hades/.kde/socket-Fedora/kdeinit4__0

I got this .and all info in page 26 .

Report

ThermalGrease
8 years ago

Just joined to say it is a fabulous piece of work, truly love it.

But... if I want to upgrade to this version should I somehow uninstall the old one before or will it just overwrite it? Doesn't wanna mess things up.

Report

HugoPereira
8 years ago

no uninstall;
it will safely overwrite.

Report

ThermalGrease
8 years ago

thx

Report

Deathmachine
8 years ago

Hello Hugo, First thanks for your great script and second is as I know right now nspluginviewer and Kdenlive doesn't work correctly with oxygen-transparent so it's will be good if you add these to "Exceptions" by default. Thanks.

Report

HugoPereira
8 years ago

ok. Done, I think. Please double check.

Report

Deathmachine
8 years ago

Thanks and sorry for posting comment three times, It happend because I've refresh my browser (Opera) after adding comment.

Report

HugoPereira
8 years ago

Will do.
Requires some time though, since I need to modify the code so that user-set exceptions do not overwrite "hard-coded" exceptions. Will give it a shot and keep you posted.
Thanks for pointing this out !

Report

Deathmachine
8 years ago

Report

Deathmachine
8 years ago

Report

Nemmeth
8 years ago

Hi Hugo.
Your mod works very fine on my PClinuxOS.
But I have to admit I quickly get into difficulties of use when the transparency is too high, it gets the windows almost unreadable.
However, I like it very much and was wondering if there'll be any chance to have the choice on which part of the windows we'd like to have transparent or not.
For instance, and excuse me to give such an example, the M$ OS windows are only transparent on the top part.
Would there be any workaround to get such choices so it will affect only the chosen part of the window, be it left or right or top or bottom.
Thank you so much anyway for your work.
It's simply excellent. :)
Cheers

Report

Frazz3
8 years ago

Commenting out the whole line worked. Thanks for the help :)

Report

Frazz3
8 years ago

I am trying to get Oxygen-Transparent working on Backtrack 5 R1 KDE.

This happens:

[email protected]:~/oxygen-transparent# ./127752-oxygen-setup.pl
--- oxygen transparent easy setup script

--- checking out source code
cd /root/oxygen-transparent/src
git checkout master
Already on 'master'
git pull
Already up-to-date.
cd /root/oxygen-transparent

--- running cmake
cd /root/oxygen-transparent/build
rm CMakeCache.txt
cmake -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DCMAKE_BUILD_TYPE=release /root/oxygen-transparent/src
-- The C compiler identification is GNU
-- The CXX compiler identification is GNU
-- Check for working C compiler: /usr/bin/gcc
-- Check for working C compiler: /usr/bin/gcc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Looking for Q_WS_X11
-- Looking for Q_WS_X11 - found
-- Looking for Q_WS_WIN
-- Looking for Q_WS_WIN - not found.
-- Looking for Q_WS_QWS
-- Looking for Q_WS_QWS - not found.
-- Looking for Q_WS_MAC
-- Looking for Q_WS_MAC - not found.
-- Found Qt-Version 4.7.0 (using /usr/bin/qmake)
-- Looking for XOpenDisplay in /usr/lib/libX11.so;/usr/lib/libXau.so;/usr/lib/libXdmcp.so
-- Looking for XOpenDisplay in /usr/lib/libX11.so;/usr/lib/libXau.so;/usr/lib/libXdmcp.so - found
-- Looking for gethostbyname
-- Looking for gethostbyname - found
-- Looking for connect
-- Looking for connect - found
-- Looking for remove
-- Looking for remove - found
-- Looking for shmat
-- Looking for shmat - found
-- Looking for IceConnectionNumber in ICE
-- Looking for IceConnectionNumber in ICE - found
-- Found X11: /usr/lib/libX11.so
-- Looking for include files CMAKE_HAVE_PTHREAD_H
-- Looking for include files CMAKE_HAVE_PTHREAD_H - found
-- Looking for pthread_create in pthreads
-- Looking for pthread_create in pthreads - not found
-- Looking for pthread_create in pthread
-- Looking for pthread_create in pthread - found
-- Found Threads: TRUE
-- Looking for _POSIX_TIMERS
-- Looking for _POSIX_TIMERS - found
-- Found Automoc4: /usr/bin/automoc4
-- Found Perl: /usr/bin/perl
-- Found Phonon: /usr/include
-- Performing Test _OFFT_IS_64BIT
-- Performing Test _OFFT_IS_64BIT - Success
-- Performing Test HAVE_FPIE_SUPPORT
-- Performing Test HAVE_FPIE_SUPPORT - Success
-- Performing Test __KDE_HAVE_W_OVERLOADED_VIRTUAL
-- Performing Test __KDE_HAVE_W_OVERLOADED_VIRTUAL - Success
-- Performing Test __KDE_HAVE_GCC_VISIBILITY
-- Performing Test __KDE_HAVE_GCC_VISIBILITY - Success
-- Found KDE 4.5 include dir: /usr/include
-- Found KDE 4.5 library dir: /usr/lib
-- Found the KDE4 kconfig_compiler preprocessor: /usr/bin/kconfig_compiler
-- Found automoc4: /usr/bin/automoc4
-- Configuring done
-- Generating done
-- Build files have been written to: /root/oxygen-transparent/build
cd /root/oxygen-transparent

--- compiling
cd /root/oxygen-transparent/build
make
[ 0%] Built target oxygentransparentstyle_automoc
[ 6%] Built target oxygentransparentstyle
[ 6%] Built target oxygentransparentstyleconfig_automoc
[ 13%] Built target oxygentransparentstyleconfig
[ 13%] Built target kwin3_oxygen_transparent_automoc
[ 23%] Built target kwin3_oxygen_transparent
[ 23%] Built target kwin_oxygen_transparent_config_automoc
[ 38%] Built target kwin_oxygen_transparent_config
[ 38%] Built target oxygen_transparent_automoc
[ 39%] Building CXX object style/CMakeFiles/oxygen_transparent.dir/oxygenstyle.o
/root/oxygen-transparent/src/style/oxygenstyle.cpp: In member function ‘void Oxygen::Style::initializeKGlobalSettings()’:
/root/oxygen-transparent/src/style/oxygenstyle.cpp:8424: error: ‘ListenForChanges’ is not a member of ‘KGlobalSettings’
make[2]: *** [style/CMakeFiles/oxygen_transparent.dir/oxygenstyle.o] Error 1
make[1]: *** [style/CMakeFiles/oxygen_transparent.dir/all] Error 2
make: *** [all] Error 2
system make>&1 failed: 512
[email protected]:~/oxygen-transparent#

Anyone has an idea what I can do about this?

Report

HugoPereira
8 years ago

PS: since this has occurred with quite a number of people already I'll probably commit an #ifdef to check on kde version in the near future.

Report

HugoPereira
8 years ago

It is because your kde (more explicitely kdelibs) version is too "old" for oxygen-transparent.
Just comment out the guilty line in the oxygen code, namely:

/root/oxygen-transparent/src/style/oxygenstyle.cpp:8424

and everything should be fine.

Hugo

Report

masterdany88
8 years ago

Hey, I found out that the blur effect dosent work in RMB menu, when I press it on window decoration on tittle bar.
You can see here what I mean.
<img>http://farm8.staticflickr.com/7007/6400247627_97c2ebbab6_b_d.jpg</img>

Report