Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
= Frequently Asked Questions =
== How do I start or bring Kupfer to front? ==
Start or show Kupfer by activating its icon in the menu/launcher of your environment. For example in GNOME, you can find Kupfer under Applications (in the category Utilities, if it exists). This method always works if Kupfer is installed, and you can always add a Kupfer launcher icon to your desktop or panel or other UI detail.
If Kupfer is already started, the most convenient way to bring it to front is using its configured keyboard shortcut, which is Ctrl+Space by default.
== How do I access Kupfer's Preferences Window? ==
- Show Kupfer as described in the previous question
- In the upper right corner of the Kupfer window, click the 'kupfer ⚙' button and select 'Preferences' in the menu that pops up.
The 'Preferences' object is also available if you search for 'Kupfer Preferences' in Kupfer itself and then run this object.
== How do I use Kupfer? ==
Start by reading the http://kupferlauncher.github.io/help/
== Do you have any tips for using Kupfer? ==
Sure! Many sections of the Kupfer User Manual contain "power user tips". There is also the editable page Apps/Kupfer/Tips with additional tips and information.
== Is Kupfer only for Gnome? ==
No. Kupfer's aim is to be well integrated with Gnome, and all settings will default to Gnome-friendly values. However, Kupfer uses cross-desktop APIs as far as possible. Working with files and applications is cross-desktop by default. External plugins can be created for applications for any (Linux) desktop by people with interest.
== How do I create plugins for Kupfer? How do I create themes for Kupfer? ==
This is covered in https://kupferlauncher.github.io/Documentation/
== How do I hide Kupfer on first launch? ==
Make sure your autostart command uses the command-line 'kupfer --no-splash'. This is what we use by default when we install the autostart file.
== Why does Kupfer start a new instance instead of forwarding the running instance? ==
Kupfer must run inside your desktop session with access its single D-Bus instance. If you run 'kupfer' outside a D-Bus session, it cannot communicate with other instances itself. Note that Kupfer never supports running more than one instance at a time (per user), regardless of session configuration.
== Can I disable window shape and compositing/transparency? ==
To completely disable any use of transparency or window shaping (when noncomposited), activate the plugin ''Custom Theme'' and select the theme ''square'' (Kupfer v205 or v206).
== Does use my user preference for Terminal Emulator? ==
No, it is configured in the program. Kupfer allows selecting which Terminal Emulator it uses (for ''Run in Terminal'', ''Open Terminal Here'', when startining a program that needs a terminal, etc). You can also configure a custom command using the plugin ''Custom Terminal'': configure a command in the plugin, then select "Custom Terminal" for terminal emulator in the first page of the preferences window.
== Can I use Super+Space in Unity? ==
Apparently not. Unity grabs the Super key in a way so that Kupfer can't bind any keyboard shortcuts or trigger shortcuts using super. This is simply their design decision and not necessarily a bad decision. You need to reconfigure Kupfer to use a different shortcut, for example the default which is Ctrl+Space.