mirror of
https://github.com/gryf/tabbedalt.git
synced 2025-12-17 11:30:31 +01:00
Changing default colors and README update.
This commit is contained in:
98
README.rst
98
README.rst
@@ -33,23 +33,83 @@ Features
|
||||
Installation
|
||||
------------
|
||||
|
||||
Copy tabbed into ``~/.urxvt`` directory.
|
||||
Copy tabbed into ``~/.urxvt/ext`` directory.
|
||||
|
||||
Add these to your ``~/.Xdefaults``::
|
||||
|
||||
! Perl extension config
|
||||
URxvt.perl-ext-common: default
|
||||
URxvt.perl-ext: tabbed
|
||||
! Any scripts placed here will override global ones with the same name
|
||||
URxvt.perl-lib: /home/user/.urxvt/
|
||||
|
||||
! Tabbed extension configuration
|
||||
URxvt.tabbed.tabbar-fg: 8
|
||||
URxvt.tabbed.tabbar-bg: 0
|
||||
URxvt.tabbed.tab-fg: 15
|
||||
URxvt.tabbed.tab-bg: 8
|
||||
And that's it. On some systems, there might be a need to reload X resources:
|
||||
|
||||
.. code:: shell-session
|
||||
|
||||
$ xrdb ~/.Xdefaults
|
||||
|
||||
Configure
|
||||
---------
|
||||
|
||||
There are several additional things you can set contrary to the original tabbed
|
||||
extension.
|
||||
|
||||
New button
|
||||
~~~~~~~~~~
|
||||
|
||||
You can disable ``[NEW]`` button, just to save the space. Just add following
|
||||
line to yours ``~/.Xdefaults`` file::
|
||||
|
||||
URxvt.tabbed.new-button: false
|
||||
|
||||
Colors
|
||||
~~~~~~
|
||||
|
||||
You can change all of the colors regarding tabs appearance. Here are defaults::
|
||||
|
||||
URxvt.tabbed.tabbar-fg: 15
|
||||
URxvt.tabbed.tabbar-bg: 8
|
||||
URxvt.tabbed.tab-fg: 8
|
||||
URxvt.tabbed.tab-bg: 0
|
||||
URxvt.tabbed.active-fg: 1
|
||||
URxvt.tabbed.actives-fg: 5
|
||||
URxvt.tabbed.actived-fg: 4
|
||||
|
||||
Tab activity
|
||||
~~~~~~~~~~~~
|
||||
|
||||
Tabs can change colors depending on the activity of terminal under certain tab.
|
||||
Colors can be defined as described in section above. You can change the time
|
||||
for either *group* of activity::
|
||||
|
||||
URxvt.tabbed.tabbar-timeouts: 16:.:8:::4:+
|
||||
|
||||
The value can should be read as colon separated fields. In this case it would
|
||||
be read as:
|
||||
|
||||
- 16 with symbol ``.``
|
||||
- 8 with symbol ``:``
|
||||
- 4 with symbol ``+``
|
||||
|
||||
Numeric values means amount of seconds, on which three group of activity will
|
||||
be triggered. Those group are:
|
||||
|
||||
- Inactive for at least 16 seconds
|
||||
- Inactive for at least 8 seconds
|
||||
- Inactive for at least 4 seconds
|
||||
|
||||
Activity of the tab is always represented by asterisk sign (``*``).
|
||||
|
||||
You can change those values but bear in mind, that first group should have
|
||||
timeout in seconds set higher, than middle one. You can also change symbols for
|
||||
those groups.
|
||||
|
||||
Tab numbers
|
||||
~~~~~~~~~~~
|
||||
|
||||
You can turn off tab numbers and leave only name of the tab. Handy to save the
|
||||
space::
|
||||
|
||||
URxvt.tabbed.tab-numbers: false
|
||||
|
||||
Creating custom classes
|
||||
-----------------------
|
||||
|
||||
@@ -72,13 +132,11 @@ custom shells defined after a gap will not work.
|
||||
Resource values are pipe separated values, which are in order:
|
||||
|
||||
* **shortcut key**, which will be used for invoking custom shell together with
|
||||
*CTRL+SHIFT* keys. Mod4 (aka Super or Windows key) are not supported, and most
|
||||
probably will be removed from script soon, as lots of window managers out
|
||||
there make a big use of those keys.
|
||||
*CTRL+SHIFT* keys.
|
||||
|
||||
*Note*: There is limitation for characters used as a shortcut. Because some of
|
||||
them are used for control terminal itself (i.e. *CTRL+SHIFT+D* may not work),
|
||||
and also other characters (digits, some special characters etc.). Letters are
|
||||
and also other characters (digits, some special characters etc.). Letters are
|
||||
case insensitive.
|
||||
|
||||
* **name of the tab**, it could be anything but the pipe.
|
||||
@@ -93,16 +151,14 @@ Let's assume, that there are already defined three custom shells, like in
|
||||
section above. If one wanted to start shell, mc and root session, following
|
||||
line should be placed in ``~/.Xdefaults``::
|
||||
|
||||
URxvt.session: N|M|R
|
||||
URxvt.tabbed.session: N|M|R
|
||||
|
||||
Launching tabbed interface
|
||||
--------------------------
|
||||
Renaming tabs
|
||||
-------------
|
||||
|
||||
After that invoke urxvt with perl extensions enabled::
|
||||
|
||||
$ urxvt -pe tabbed
|
||||
|
||||
That's all.
|
||||
On runtime, tabs can be renamed using ``SHIFT+UP`` - now you can type name for
|
||||
the tab. ``Return`` accept change, ``ESC`` cancels it. This feature was taken
|
||||
from `stepb`_ tabbedx repository.
|
||||
|
||||
.. _urxvt-unicode: http://software.schmorp.de/pkg/rxvt-unicode.html
|
||||
.. _activity indicator: http://mina86.com/2009/05/16/tabbed-urxvt-extension/
|
||||
|
||||
10
tabbed
10
tabbed
@@ -103,6 +103,10 @@
|
||||
#
|
||||
# 2013-11-26 19:31:55
|
||||
# - Added parentheses for hook, should work on Debian now.
|
||||
#
|
||||
# 2019-06-05 10:55:37
|
||||
# - fixed couple of bugs regarding session
|
||||
# - changed default colors to more sane values
|
||||
|
||||
|
||||
sub tab_activity_mark ($$) {
|
||||
@@ -380,10 +384,10 @@ sub on_init {
|
||||
my $actives = $self->x_resource ("actives-fg");
|
||||
my $actived = $self->x_resource ("actived-fg");
|
||||
|
||||
defined $fg or $fg = 3;
|
||||
defined $fg or $fg = 8;
|
||||
defined $bg or $bg = 0;
|
||||
defined $tabfg or $tabfg = 0;
|
||||
defined $tabbg or $tabbg = 1;
|
||||
defined $tabfg or $tabfg = 15;
|
||||
defined $tabbg or $tabbg = 8;
|
||||
defined $active or $active = 1;
|
||||
defined $actives or $actives = 5;
|
||||
defined $actived or $actived = 4;
|
||||
|
||||
Reference in New Issue
Block a user