literate-dotfiles/docs/notifications.html

321 lines
9.5 KiB
HTML
Raw Normal View History

2020-01-11 22:04:45 +01:00
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
2020-05-26 08:40:15 +02:00
<!-- 2020-05-26 mar. 08:40 -->
2020-01-11 22:04:45 +01:00
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<title>Dunst (Notification Manager)</title>
<meta name="generator" content="Org mode" />
<meta name="author" content="Dehaeze Thomas" />
2020-01-11 22:22:46 +01:00
<link rel="stylesheet" type="text/css" href="./css/htmlize.css"/>
<link rel="stylesheet" type="text/css" href="./css/readtheorg.css"/>
<script type="text/javascript" src="./js/jquery.min.js"></script>
<script type="text/javascript" src="./js/bootstrap.min.js"></script>
<script type="text/javascript" src="./js/jquery.stickytableheaders.min.js"></script>
<script type="text/javascript" src="./js/readtheorg.js"></script>
2020-01-11 22:04:45 +01:00
</head>
<body>
<div id="org-div-home-and-up">
<a accesskey="h" href="./index.html"> UP </a>
|
<a accesskey="H" href="./index.html"> HOME </a>
</div><div id="content">
<h1 class="title">Dunst (Notification Manager)</h1>
<div id="table-of-contents">
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#org8a20fe1">Global</a>
<ul>
<li><a href="#org1538ca5">Display</a></li>
<li><a href="#org3209801">Text</a></li>
<li><a href="#org0b3fe43">Icons</a></li>
<li><a href="#orgfccb12b">History</a></li>
<li><a href="#org4cdd8ed">Misc/Advanced</a></li>
</ul>
</li>
<li><a href="#orga574d4b">Shortcuts</a></li>
<li><a href="#org2443a5f">Urgency</a></li>
</ul>
</div>
</div>
<div id="outline-container-org8a20fe1" class="outline-2">
<h2 id="org8a20fe1">Global</h2>
<div class="outline-text-2" id="text-org8a20fe1">
<div class="org-src-container">
2020-05-26 08:40:15 +02:00
<pre class="src src-conf">[global]
2020-01-11 22:04:45 +01:00
</pre>
</div>
</div>
<div id="outline-container-org1538ca5" class="outline-3">
<h3 id="org1538ca5">Display</h3>
<div class="outline-text-3" id="text-org1538ca5">
<div class="org-src-container">
2020-05-26 08:40:15 +02:00
<pre class="src src-conf"># Which monitor should the notifications be displayed on.
monitor = 0
# Display notification on focused monitor. Possible modes are:
# mouse: follow mouse pointer
# keyboard: follow window with keyboard focus
# none: don't follow anything
#
# "keyboard" needs a windowmanager that exports the
# _NET_ACTIVE_WINDOW property.
# This should be the case for almost all modern windowmanagers.
#
# If this option is set to mouse or keyboard, the monitor option
# will be ignored.
follow = keyboard
# The geometry of the window:
# [{width}]x{height}[+/-{x}+/-{y}]
# The geometry of the message window.
# The height is measured in number of notifications everything else
# in pixels. If the width is omitted but the height is given
# ("-geometry x2"), the message window expands over the whole screen
# (dmenu-like). If width is 0, the window expands to the longest
# message displayed. A positive x is measured from the left, a
# negative from the right side of the screen. Y is measured from
# the top and down respectevly.
# The width can be negative. In this case the actual width is the
# screen width minus the width defined in within the geometry option.
geometry = "250x50-10+37"
# Show how many messages are currently hidden (because of geometry).
indicate_hidden = yes
# Shrink window if it's smaller than the width. Will be ignored if
# width is 0.
shrink = no
# The transparency of the window. Range: [0; 100].
# This option will only work if a compositing windowmanager is
# present (e.g. xcompmgr, compiz, etc.).
transparency = 0
# The height of the entire notification. If the height is smaller
# than the font height and padding combined, it will be raised
# to the font height and padding.
notification_height = 0
# Draw a line of "separator_height" pixel height between two
# notifications.
# Set to 0 to disable.
separator_height = 4
# Padding between text and separator.
padding = 16
# Horizontal padding.
horizontal_padding = 16
# Defines width in pixels of frame around the notification window.
# Set to 0 to disable.
frame_width = 2
# Defines color of the frame around the notification window.
frame_color = "#32302f"
# Define a color for the separator.
# possible values are:
# * auto: dunst tries to find a color fitting to the background;
# * foreground: use the same color as the foreground;
# * frame: use the same color as the frame;
# * anything else will be interpreted as a X color.
separator_color = frame
# Don't remove messages, if the user is idle (no mouse or keyboard input)
# for longer than idle_threshold seconds.
# Set to 0 to disable.
# default 120
idle_threshold = 120
# Sort messages by urgency.
sort = yes
2020-01-11 22:04:45 +01:00
</pre>
</div>
</div>
</div>
2020-05-26 08:40:15 +02:00
2020-01-11 22:04:45 +01:00
<div id="outline-container-org3209801" class="outline-3">
<h3 id="org3209801">Text</h3>
<div class="outline-text-3" id="text-org3209801">
<div class="org-src-container">
2020-05-26 08:40:15 +02:00
<pre class="src src-conf">font = Hack Nerd Font 10
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# The height of a single line. If the height is smaller than the
# font height, it will get raised to the font height.
# This adds empty space above and under the text.
line_height = 4
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Possible values are:
# full: Allow a small subset of html markup in notifications:
# &lt;b&gt;bold&lt;/b&gt;
# &lt;i&gt;italic&lt;/i&gt;
# &lt;s&gt;strikethrough&lt;/s&gt;
# &lt;u&gt;underline&lt;/u&gt;
2020-01-11 22:04:45 +01:00
#
2020-05-26 08:40:15 +02:00
# For a complete reference see
# &lt;http://developer.gnome.org/pango/stable/PangoMarkupFormat.html&gt;.
2020-01-11 22:04:45 +01:00
#
# strip: This setting is provided for compatibility with some broken
# clients that send markup even though it's not enabled on the
# server. Dunst will try to strip the markup but the parsing is
# simplistic so using this option outside of matching rules for
# specific applications *IS GREATLY DISCOURAGED*.
#
# no: Disable markup parsing, incoming notifications will be treated as
# plain text. Dunst will not advertise that it has the body-markup
# capability if this is set as a global setting.
#
# It's important to note that markup inside the format option will be parsed
# regardless of what this is set to.
markup = full
# The format of the message. Possible variables are:
# %a appname
# %s summary
# %b body
# %i iconname (including its path)
# %I iconname (without its path)
# %p progress value if set ([ 0%] to [100%]) or nothing
# %n progress value if set without any extra characters
# Markup is allowed
2020-05-26 08:40:15 +02:00
format = "&lt;b&gt;%s&lt;/b&gt;\n%b"
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Alignment of message text.
# Possible values are "left", "center" and "right".
alignment = left
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Show age of message if message is older than show_age_threshold
# seconds.
# Set to -1 to disable.
show_age_threshold = 300
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Split notifications into multiple lines if they don't fit into
# geometry.
word_wrap = yes
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Ignore newlines '\n' in notifications.
ignore_newline = no
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Merge multiple notifications with the same content
stack_duplicates = false
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Hide the count of merged notifications with the same content
hide_duplicate_count = false
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Display indicators for URLs (U) and actions (A).
show_indicators = yes
</pre>
</div>
</div>
</div>
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
<div id="outline-container-org0b3fe43" class="outline-3">
<h3 id="org0b3fe43">Icons</h3>
<div class="outline-text-3" id="text-org0b3fe43">
<div class="org-src-container">
<pre class="src src-conf"># Align icons left/right/off
icon_position = off
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Limit icons size.
max_icon_size=32
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Paths to default icons.
icon_path = /usr/share/icons/Arc/16x16/status/:/usr/share/icons/Arc/16x16/devices/
2020-01-11 22:04:45 +01:00
</pre>
</div>
</div>
</div>
<div id="outline-container-orgfccb12b" class="outline-3">
<h3 id="orgfccb12b">History</h3>
<div class="outline-text-3" id="text-orgfccb12b">
<div class="org-src-container">
2020-05-26 08:40:15 +02:00
<pre class="src src-conf"># Should a notification popped up from history be sticky or timeout
# as if it would normally do.
sticky_history = yes
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Maximum amount of notifications kept in history
history_length = 20
2020-01-11 22:04:45 +01:00
</pre>
</div>
</div>
</div>
<div id="outline-container-org4cdd8ed" class="outline-3">
<h3 id="org4cdd8ed">Misc/Advanced</h3>
<div class="outline-text-3" id="text-org4cdd8ed">
<div class="org-src-container">
2020-05-26 08:40:15 +02:00
<pre class="src src-conf"># dmenu path.
dmenu = /usr/bin/dmenu -p dunst:
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Browser for opening urls in context menu.
browser = $BROWSER
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Always run rule-defined scripts, even if the notification is suppressed
always_run_script = true
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Define the title of the windows spawned by dunst
title = Dunst
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Define the class of the windows spawned by dunst
class = Dunst
2020-01-11 22:04:45 +01:00
2020-05-26 08:40:15 +02:00
# Print a notification on startup.
# This is mainly for error detection, since dbus (re-)starts dunst
# automatically after a crash.
startup_notification = false
2020-01-11 22:04:45 +01:00
</pre>
</div>
</div>
</div>
</div>
<div id="outline-container-orga574d4b" class="outline-2">
<h2 id="orga574d4b">Shortcuts</h2>
<div class="outline-text-2" id="text-orga574d4b">
<div class="org-src-container">
2020-05-26 08:40:15 +02:00
<pre class="src src-conf">[shortcuts]
# Available modifiers are "ctrl", "mod1" (the alt-key), "mod2",
# "mod3" and "mod4" (windows-key).
close = mod1+space
history = mod1+Escape
2020-01-11 22:04:45 +01:00
</pre>
</div>
</div>
</div>
<div id="outline-container-org2443a5f" class="outline-2">
<h2 id="org2443a5f">Urgency</h2>
<div class="outline-text-2" id="text-org2443a5f">
<div class="org-src-container">
2020-05-26 08:40:15 +02:00
<pre class="src src-conf">[urgency_low]
background = "#32302f"
foreground = "#ebdbb2"
timeout = 4
[urgency_normal]
background = "#32302f"
foreground = "#ebdbb2"
timeout = 6
[urgency_critical]
background = "#32302f"
foreground = "#cc241d"
timeout = 0
2020-01-11 22:04:45 +01:00
</pre>
</div>
</div>
</div>
</div>
<div id="postamble" class="status">
<p class="author">Author: Dehaeze Thomas</p>
2020-05-26 08:40:15 +02:00
<p class="date">Created: 2020-05-26 mar. 08:40</p>
2020-01-11 22:04:45 +01:00
</div>
</body>
</html>