Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fedora distro packages writeup in docs #30

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
+14 −6
Open

Fedora distro packages writeup in docs #30

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 14 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
#gtk3-nocsd
# gtk3-nocsd

gtk3-nocsd is a small module used to disable the client side decoration
of Gtk+ 3.

##Introduction:
## Introduction:
Since Gtk+ 3.10, its developers added a so-called header bar or custom
title bar. With this and the client-side decoration, the original title
bar and window border provided by the window manager are disabled by
Expand All @@ -16,15 +16,15 @@ standards and provide "no option" to turn it off.
Luckily, with gtk3-nocsd, we still have a way to (partially) turn it
off. Window manager (title bar and window border) can be re-enabled.

##Preview:
## Preview:
This is how the gtk3 windows look like before and after using
`gtk3-nocsd`.

![Screenshot of gedit with CSDs still enabled](gedit-with-csd.png)

![Screenshot of gedit with CSDs disabled by gtk3-nocsd](gedit-without-csd.png)

#How to use:
# How to use:

* gtk3-nocsd should work with all Gtk+ 3 versions.

Expand Down Expand Up @@ -74,7 +74,7 @@ This is how the gtk3 windows look like before and after using

* Hooray! GTK+ 3 client-side decorations are disabled now.

#Distribution packages:
# Distribution packages:

gtk3-nocsd is packaged in Debian's unstable and testing distributions,
see [gtk3-nocsd in Debian's package database](https://packages.debian.org/testing/gtk3-nocsd).
Expand All @@ -85,7 +85,15 @@ re-login is required to have CSDs disabled on non-GNOME desktops.
There is also a [gtk3-nocsd-git](https://aur.archlinux.org/packages/gtk3-nocsd-git/)
package for Arch Linux.

#How it works:
A [gtk3-nocsd copr repository](https://copr.fedorainfracloud.org/coprs/hdfssk/gtk3-nocsd/)
is available for currently supported Fedora releases. It also includes
integration code, automatically disabling CSDs for non-GNOME desktops,
and can be installed with these commands:

# dnf copr enable hdfssk/gtk3-nocsd
# dnf install gtk3-nocsd

# How it works:

`$LD_PRELOAD` is used to override several Gdk and glib/gobject APIs to
intercept related calls Gtk+ 3 uses to setup CSDs. For older versions
Expand Down