mirror of
https://github.com/taigrr/wtf
synced 2025-01-18 04:03:14 -08:00
473 lines
14 KiB
HTML
473 lines
14 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<title>WTF - the terminal dashboard</title>
|
|
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
|
|
<meta name="generator" content="Hugo 0.46" />
|
|
<title>Configuration :: WTF - the terminal dashboard</title>
|
|
<link rel="shortcut icon" href="/images/favicon.png" type="image/x-icon" />
|
|
<link href="/css/font-awesome.min.css" rel="stylesheet">
|
|
<link href="/css/nucleus.css" rel="stylesheet">
|
|
<link href="/theme-flex/style.css" rel="stylesheet">
|
|
|
|
<link rel="stylesheet" href="/css/bootstrap.min.css">
|
|
<script src="/js/jquery-2.x.min.js"></script>
|
|
<script type="text/javascript">
|
|
var baseurl = "https:\/\/wtfutil.com\/";
|
|
</script>
|
|
<meta name="description" content="">
|
|
|
|
|
|
<link rel="stylesheet" href="/css/custom.css">
|
|
|
|
|
|
|
|
</head>
|
|
<body data-url="/configuration/">
|
|
|
|
<header>
|
|
<div class="logo">
|
|
|
|
|
|
|
|
<a class="baselink" href="https://wtfutil.com/">WTF - the terminal dashboard</a>
|
|
|
|
|
|
</div>
|
|
<div class="burger"><a href="javascript:void(0);" style="font-size:15px;">☰</a></div>
|
|
<nav class="shortcuts">
|
|
<li class="" role="">
|
|
<a href="https://github.com/senorprogrammer/wtf" rel="noopener">
|
|
<i class='fa fa-github'></i> <label>WTF on Github</label>
|
|
</a>
|
|
</li>
|
|
<li class="" role="">
|
|
<a href="https://github.com/senorprogrammer/wtf/releases" rel="noopener">
|
|
<i class='fa fa-cloud-download'></i> <label>Download WTF</label>
|
|
</a>
|
|
</li>
|
|
<li class="" role="">
|
|
<a href="https://github.com/senorprogrammer/wtf/blob/master/README.md#contributors" rel="noopener">
|
|
<i class='fa fa-bullhorn'></i> <label>Credits</label>
|
|
</a>
|
|
</li>
|
|
</nav>
|
|
</header>
|
|
<article>
|
|
<aside>
|
|
<ul class="menu">
|
|
<li data-nav-id="/" class="dd-item">
|
|
<a href="/">
|
|
<i class="fa fa-fw fa-home"></i>
|
|
</a>
|
|
</li>
|
|
<li data-nav-id="/getting_started/" class="dd-item haschildren
|
|
">
|
|
<div>
|
|
<a href="/getting_started/">Getting Started</a><i class="fa fa-angle-right fa-lg category-icon"></i><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
<ul>
|
|
<li data-nav-id="/getting_started/installation/" class="dd-item">
|
|
<div>
|
|
<a href="/getting_started/installation/">
|
|
Installation
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/getting_started/glossary/" class="dd-item">
|
|
<div>
|
|
<a href="/getting_started/glossary/">
|
|
Glossary
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li data-nav-id="/configuration/" class="dd-item parent active haschildren
|
|
">
|
|
<div>
|
|
<a href="/configuration/">Configuration</a>
|
|
<i class="fa fa-angle-down fa-lg category-icon"></i><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
<ul>
|
|
<li data-nav-id="/configuration/attributes/" class="dd-item">
|
|
<div>
|
|
<a href="/configuration/attributes/">
|
|
Attributes
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/configuration/iterm2/" class="dd-item">
|
|
<div>
|
|
<a href="/configuration/iterm2/">
|
|
iTerm2
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li data-nav-id="/modules/" class="dd-item haschildren
|
|
">
|
|
<div>
|
|
<a href="/modules/">Modules</a><i class="fa fa-angle-right fa-lg category-icon"></i><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
<ul>
|
|
<li data-nav-id="/modules/bamboohr/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/bamboohr/">
|
|
BambooHR
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/circleci/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/circleci/">
|
|
CircleCI
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/clocks/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/clocks/">
|
|
Clocks
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/cmdrunner/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/cmdrunner/">
|
|
CmdRunner
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/gerrit/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/gerrit/">
|
|
Gerrit
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/git/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/git/">
|
|
Git
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/github/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/github/">
|
|
GitHub
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/gitlab/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/gitlab/">
|
|
GitLab
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/gitter/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/gitter/">
|
|
Gitter
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/hackernews/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/hackernews/">
|
|
Hacker News
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/jenkins/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/jenkins/">
|
|
Jenkins
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/jira/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/jira/">
|
|
Jira
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/logger/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/logger/">
|
|
Logger
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/newrelic/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/newrelic/">
|
|
New Relic
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/opsgenie/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/opsgenie/">
|
|
OpsGenie
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/power/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/power/">
|
|
Power
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/security/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/security/">
|
|
Security
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/textfile/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/textfile/">
|
|
Textfile
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/todo/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/todo/">
|
|
Todo
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/todoist/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/todoist/">
|
|
Todoist
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/travisci/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/travisci/">
|
|
TravisCI
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/trello/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/trello/">
|
|
Trello
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/twitter/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/twitter/">
|
|
Twitter
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
<li data-nav-id="/modules/zendesk/" class="dd-item">
|
|
<div>
|
|
<a href="/modules/zendesk/">
|
|
Zendesk
|
|
</a><i class="fa fa-circle-thin read-icon"></i>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
<section>
|
|
</section>
|
|
</aside>
|
|
<section class="page">
|
|
|
|
<div class="nav-select">
|
|
<center>Navigation :
|
|
<select onchange="javascript:location.href = this.value;">
|
|
|
|
<option value="/getting_started/" >
|
|
Getting Started</option>
|
|
<option value="/configuration/" selected>
|
|
Configuration</option>
|
|
<option value="/configuration/attributes/" >- Attributes</option>
|
|
<option value="/configuration/iterm2/" >- iTerm2</option>
|
|
|
|
<option value="/modules/" >
|
|
Modules</option>
|
|
|
|
|
|
|
|
</select>
|
|
</center>
|
|
</div>
|
|
<div>
|
|
<div class="searchbox">
|
|
<input data-search-input id="search-by" type="text" placeholder="Search...">
|
|
</div>
|
|
<script type="text/javascript" src="/js/lunr.min.js"></script>
|
|
<script type="text/javascript" src="/js/auto-complete.js"></script>
|
|
<link href="/css/auto-complete.css" rel="stylesheet">
|
|
<script type="text/javascript">
|
|
|
|
var baseurl = "https:\/\/wtfutil.com\/";
|
|
|
|
</script>
|
|
<script type="text/javascript" src="/js/search.js"></script>
|
|
</div>
|
|
|
|
|
|
<h1>Configuration</h1>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2 id="index">Index</h2>
|
|
|
|
<ul>
|
|
<li><a href="#configuration-files">Configuration Files</a>
|
|
|
|
<ul>
|
|
<li><a href="#example-configuration-files">Example Configuration Files</a></li>
|
|
<li><a href="#custom-configuration-files">Custom Configuration Files</a></li>
|
|
<li><a href="#configuration-attributes">Configuration Attributes</a></li>
|
|
</ul></li>
|
|
<li><a href="#grid-layout">Grid Layout</a></li>
|
|
</ul>
|
|
|
|
<h2 id="configuration-files">Configuration Files</h2>
|
|
|
|
<p>By default WTF looks in a <code>~/.config/wtf/</code> directory for a YAML file called
|
|
<code>config.yml</code>. If the <code>~/.config/wtf/</code> directory doesn’t exist, WTF will create that directory
|
|
on start-up, and then display instructions for creating a new
|
|
configuration file.</p>
|
|
|
|
<p>In other words, WTF expects to have a YAML config file at: <code>~/.config/wtf/config.yml</code>.</p>
|
|
|
|
<h4 id="example-configuration-files">Example Configuration Files</h4>
|
|
|
|
<p>A couple of example config files are provided in the <code>_sample_configs/</code>
|
|
directory of the Git repository.</p>
|
|
|
|
<p>To try out WTF quickly, copy
|
|
<code>simple_config.yml</code> into <code>~/.config/wtf/</code> as <code>config.yml</code> and relaunch WTF. You
|
|
should see the app launch and display the <a href="/posts/modules/security/">Security</a>,
|
|
<a href="/posts/modules/clocks/">Clocks</a> and <a href="/posts/modules/status/">Status</a> widgets onscreen.</p>
|
|
|
|
<h4 id="custom-configuration-files">Custom Configuration Files</h4>
|
|
|
|
<p>To try out different configurations (or run multiple instances of WTF),
|
|
you can pass the path to a config file via command line arguments on
|
|
start-up.</p>
|
|
|
|
<p>To load a custom configuration file (ie: one that’s not
|
|
<code>~/.config/wtf/config.yml</code>), pass in the path to configuration file as a
|
|
parameter on launch:</p>
|
|
<div class="highlight"><pre class="chroma"><code class="language-bash" data-lang="bash"> $> wtf --config<span class="o">=</span>path/to/custom/config.yml</code></pre></div>
|
|
<h4 id="configuration-attributes">Configuration Attributes</h4>
|
|
|
|
<p>A number of top-level attributes can be set to customize your WTF
|
|
install. See <a href="/posts/configuration/attributes/">Attributes</a> for details.</p>
|
|
|
|
<h2 id="grid-layout">Grid Layout</h2>
|
|
|
|
<p>WTF uses the <code>Grid</code> layout system from <a href="https://github.com/rivo/tview/blob/master/grid.go">tview</a> to position widgets
|
|
onscreen. It’s not immediately obvious how this works, so here’s an
|
|
explanation:</p>
|
|
|
|
<p>Think of your terminal screen as a matrix of letter positions, say <code>100</code> chrs wide and <code>58</code> chrs tall.</p>
|
|
|
|
<p>Columns breaks up the width of the screen into chunks, each chunk a specified number of characters wide. use</p>
|
|
|
|
<p><code>[10, 10, 10, 10, 10, 10, 10, 10, 10, 10]</code></p>
|
|
|
|
<p>Ten columns that are ten characters wide</p>
|
|
|
|
<p>Rows break up the height of the screen into chunks, each chunk a specified number of characters tall. If we wanted to have five rows:</p>
|
|
|
|
<p><code>[10, 10, 10, 10, 18]</code></p>
|
|
|
|
<p>The co-ordinate system starts at top-left and defines how wide and tall a widget is. If we wanted to put a 2-col, 2-row widget in the bottom of the screen, we’d position it at:</p>
|
|
|
|
<pre><code> top: 4 // top starts in the 4th row
|
|
left: 9 // left starts in the 9th column
|
|
height: 2 // span down rows 4 & 5 (18 characters in size, total)
|
|
width: 2 // span across cols 9 & 10 (20 characters in size, total)
|
|
</code></pre>
|
|
|
|
|
|
|
|
|
|
|
|
<div class="chevrons">
|
|
<div id="navigation">
|
|
<a class="nav nav-prev" href="/getting_started/glossary/" title="Glossary"> <i class="fa fa-chevron-left"></i><label>Glossary</label></a>
|
|
<a class="nav nav-next" href="/configuration/attributes/" title="Attributes" style="margin-right: 0px;"><label>Attributes</label><i class="fa fa-chevron-right"></i></a></div>
|
|
</div>
|
|
|
|
</section>
|
|
</article>
|
|
|
|
<footer>
|
|
|
|
<div class="footline">
|
|
|
|
|
|
|
|
|
|
|
|
<div class="date">
|
|
<i class='fa fa-calendar'></i> Last update on 15/04/2018
|
|
</div>
|
|
|
|
|
|
<div class="github-link">
|
|
<a href="https://github.com/vjeantet/hugo-theme-docdock/edit/master/exampleSite/content/configuration/_index.md" target="blank"><i class="fa fa-code-fork"></i>
|
|
Improve this page</a>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
</footer>
|
|
|
|
<script src="/js/clipboard.min.js"></script>
|
|
|
|
<link href="/css/featherlight.min.css" rel="stylesheet">
|
|
<script src="/js/featherlight.min.js"></script>
|
|
|
|
|
|
|
|
<script src="/theme-flex/script.js"></script>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</body>
|
|
</html> |