You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Chris Cummer 6f9b837d26
Update README.md
8 hours ago
.github Update Bug.md 9 months ago
_sample_configs feat: update sample configs 2 weeks ago
cfg Add more 'man page' like functionality 2 days ago
checklist Some code improvements 4 days ago
checklist_tests WTF-427 Use new keyboard implementation for widgets. Closes #427 2 weeks ago
flags Re-add command line help 2 weeks ago
generator Add a global Redraw method for TextWidget 2 weeks ago
help Add more 'man page' like functionality 2 days ago
images Fix broken image links in README 7 months ago
logger Split up logger and widget 2 weeks ago
maker Remove 'system' widget from the widget initialization 1 week ago
modules Tabbing to widgets properly sets the IsFocused property. Closes #467 14 hours ago
utils Add more 'man page' like functionality 2 days ago
wtf Tabbing to widgets properly sets the IsFocused property. Closes #467 14 hours ago
wtf_tests WTF-400 Common settings implemented 1 month ago
.all-contributorsrc Update .all-contributors 4 days ago
.codeclimate.yml Fix invalid .codeclimate.yml 9 months ago
.editorconfig Minor git tweaks 11 months ago
.gitattributes Update .gitattributes 9 months ago
.gitignore .vscode dir into .gitignore 1 month ago
.gitmodules Delete the docdock theme submodule 9 months ago
.goreleaser.yml Remove Windows build target. It fails to build 1 week ago
.travis.yml feat: update to go modules 4 weeks ago
CHANGELOG.md Update CHANGELOG.md 14 hours ago
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 11 months ago
CONTRIBUTING.md Update CONTRIBUTING.md 8 hours ago
LICENSE.md Change license to MPL v2 11 months ago
Makefile Export Go module variables in Makefile 4 weeks ago
README.md Update README.md 8 hours ago
go.mod remove glog mod dep 6 days ago
go.sum WTF-455 Pass nil options for Gitlab project. Closes #455 1 week ago
main.go Improve keyboard handling in main.go 1 day ago

README.md

All Contributors Build Status Gitter Chat Twitter Go Report Card

WTF

A personal terminal-based dashboard utility, designed for displaying infrequently-needed, but very important, daily data.

Screenshot

Communication

Slack

If you’re a member of the Gophers Slack community (https://invite.slack.golangbridge.org) there’s a WTFUtil channel you should join for all your WTF questions, development conversations, etc.

Find #wtfutil on https://gophers.slack.com/ and join us.

Twitter

Also, follow on Twitter for news and latest updates.

Quick Start

Download and run the latest binary or install from source.

If you want to run the build command from within your $GOPATH:

# Set the Go proxy variable to GoCenter
export GOPROXY="https://gocenter.io"
# Enable Go modules
export GO111MODULE=on
go get -u github.com/wtfutil/wtf
cd $GOPATH/src/github.com/wtfutil/wtf
make install
make run

If you want to run the build command from a folder that is not in your $GOPATH:

# Set the Go proxy variable to GoCenter
export GOPROXY="https://gocenter.io"
go get -u github.com/wtfutil/wtf
cd $GOPATH/src/github.com/wtfutil/wtf
make install
make run

Note: WTF is only compatible with Go versions 1.11.0 or later (due to the use of Go modules). It currently does not compile with gccgo.

Documentation

See https://wtfutil.com for the definitive documentation. Here’s some short-cuts:

Contributing to the Documentation

Documentation now lives in its own repository here: https://github.com/wtfutil/wtfdocs.

Please make all additions and updates to documentation in that repository.

Contributing to the Source Code

First, please read Talk, then code by Dave Cheney. It’s great advice and will often save a lot of time and effort.

Next, please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.

Then create your branch, write your code, submit your PR, and join the rest of the awesome people who’ve contributed their time and effort towards WTF. Without their contributors, WTF wouldn’t be possible.

And don’t worry if you’ve never written Go before, or never contributed to an open source project before, or that your code won’t be good enough. For a surprising number of people WTF has been their first Go project, or first open source contribution. If you’re here, and you’ve read this far, you’re the right stuff.

Adding Dependencies

Dependency management in WTF is handled by Go modules. Please check out that page for more details on how Go modules work.

Contributors

Chris Cummer
Chris Cummer

Anand Sudhir Prayaga
Anand Sudhir Prayaga

Hossein Mehrabi
Hossein Mehrabi

FengYa
FengYa

deltax
deltax

Bill Keenan
Bill Keenan

June S
June S

liyiheng
liyiheng

baustinanki
baustinanki

lucus lee
lucus lee

Mike Lloyd
Mike Lloyd

Sergio Rubio
Sergio Rubio

Farhad Farahi
Farhad Farahi

Lasantha Kularatne
Lasantha Kularatne

Mark Old
Mark Old

flw
flw

David Barda
David Barda

Geoff Lee
Geoff Lee

George Opritescu
George Opritescu

Grazfather
Grazfather

Michael Cordell
Michael Cordell

Patrick José Pereira
Patrick José Pereira

sherod taylor
sherod taylor

Andrew Scott
Andrew Scott

Lassi Piironen
Lassi Piironen

BlackWebWolf
BlackWebWolf

andrewzolotukhin
andrewzolotukhin

Leon Stigter
Leon Stigter

Amr Tamimi
Amr Tamimi

Jagdeep Singh
Jagdeep Singh

Lineu Felipe
Lineu Felipe

Konstantin
Konstantin

Brendan O'Leary
Brendan O’Leary

bertl4398
bertl4398

Ferenc-
Ferenc-

Rohan Verma
Rohan Verma

Tim Fitzgerald
Tim Fitzgerald

Federico Ruggi
Federico Ruggi

Craig Woodward
Craig Woodward

ReadmeCritic
ReadmeCritic

Eugene
Eugene

Kenny Wu
Kenny Wu

Renán Romero
Renán Romero

Bastian Groß
Bastian Groß

nicholas-eden
nicholas-eden

Dan Rabinowitz
Dan Rabinowitz

David Missmann
David Missmann

Mathias Weber
Mathias Weber

TheRedSpy15
TheRedSpy15

Harald Nordgren
Harald Nordgren

Matei Alexandru Gardus
Matei Alexandru Gardus

Sean Smith
Sean Smith

Halil Kaskavalci
Halil Kaskavalci

Johan Denoyer
Johan Denoyer

Jelle Vink
Jelle Vink

Devin Collins
Devin Collins

Danne Stayskal
Danne Stayskal

Max Beizer
Max Beizer


E:V:A

Gabriel
Gabriel

Andrew Scibek
Andrew Scibek

FriedCosey
FriedCosey

Michele Gerarduzzi
Michele Gerarduzzi

Jack Morris
Jack Morris

foorb
foorb

Levi Baber
Levi Baber

Graham Anderson
Graham Anderson

Romain Bossart
Romain Bossart

Kirill Motkov
Kirill Motkov

Acknowledgments

The inspiration for WTF came from Monica Dinculescu’s tiny-care-terminal.

Many thanks to Lendesk for supporting this project by providing time to develop it.