cointop/README.md

cointop

Coin tracking for hackers

cointop is a fast and lightweight interactive terminal based UI application for tracking and monitoring cryptocurrency coin stats in real-time. The interface is inspired by htop.

Table of Contents

• Features
• Install
• Updating
• Usage
• Shortcuts
• Config
• Actions
• FAQ
• Authors
• License

Features

• Quick sort shortcuts
• Vim style keys
• Pagination
• 7 day charts
• Color coded
• Custom key bindings

Future releases

• Advanced search
• "Favorites" list
• Currency conversion (i.e. Euro, Yen)
• Markets/Exchanges
• CryptoCompare API

Install

Make sure to have go (1.9+) installed, then do:

go get -u github.com/miguelmota/cointop

Updating

To update make sure to use the -u flag.

go get -u github.com/miguelmota/cointop

Usage

Just run the cointop command to get started:

$ cointop

Shortcuts

List of default shortcut keys:

Key	Action
↑	Move up
↓	Move down
→	Go to next page
←	Go to previous page
Page Up	Jump page up
Page Down	Jump page down
Home	Go to first line of page
End	Go to last line of page
Enter	Visit highlighted coin on CoinMarketCap
Esc	Alias to quit
Space	Alias to enter key
Ctrl+c	Alias to quit
Ctrl+d	Jump page down (vim style)
Ctrl+n	Go to next page (vim style)
Ctrl+p	Go to previous page (vim style)
Ctrl+r	Force refresh
Ctrl+u	Jump page up (vim style)
Alt+↑	Sort current column in ascending order
Alt+↓	Sort current column in descending order
Alt+←	Sort column to the left
Alt+→	Sort column to the right
F1	Show help
0	Go to first page (vim style)
1	Sort table by [1] hour change
2	Sort table by [2]4 hour change
7	Sort table by [7] day change
a	Sort table by [a]vailable supply
c	Toggle [c]hart for highlighted coin
g	Go to first line of page (vim style)
G	Go to last line of page (vim style)
h	Go to previous page (vim style)
H	Go to top of table window (vim style)
j	Move down (vim style)
k	Move up (vim style)
l	Go to next page (vim style)
L	Go to last line of visible table window (vim style)
m	Sort table by [m]arket cap
M	Go to middle of visible table window (vim style)
n	Sort table by [n]ame
o	[o]pen row link
p	Sort table by [p]rice
r	Sort table by [r]ank
s	Sort table by [s]ymbol
t	Sort table by [t]otal supply
u	Sort table by last [u]pdated
v	Sort table by 24 hour [v]olume
q	[q]uit
$	Go to last page (vim style)
?	Show help

Config

The first time you run cointop, it'll create a config file in:

~/.cointop/config

You can then configure the actions you want for each key:

(default ~/.cointop/config)

[shortcuts]
  "$" = "last_page"
  0 = "first_page"
  1 = "sort_column_1h_change"
  2 = "sort_column_24h_change"
  7 = "sort_column_7d_change"
  "?" = "help"
  G = "move_to_page_last_row"
  H = "move_to_page_visible_first_row"
  L = "move_to_page_visible_last_row"
  M = "move_to_page_visible_middle_row"
  a = "sort_column_available_supply"
  "alt+arrowdown" = "sort_column_desc"
  "alt+arrowleft" = "sort_left_column"
  "alt+arrowright" = "sort_right_column"
  "alt+arrowup" = "sort_column_asc"
  arrowdown = "move_down"
  arrowleft = "previous_page"
  arrowright = "next_page"
  arrowup = "move_up"
  c = "toggle_row_chart"
  "ctrl+c" = "quit"
  "ctrl+d" = "page_down"
  "ctrl+n" = "next_page"
  "ctrl+p" = "previous_page"
  "ctrl+r" = "refresh"
  "ctrl+u" = "page_up"
  end = "move_to_page_last_row"
  enter = "open_link"
  esc = "quit"
  f1 = "help"
  g = "move_to_page_first_row"
  h = "previous_page"
  home = "move_to_page_first_row"
  j = "move_down"
  k = "move_up"
  l = "next_page"
  m = "sort_column_market_cap"
  n = "sort_column_name"
  o = "open_link"
  p = "sort_column_price"
  pagedown = "page_down"
  pageup = "page_up"
  q = "quit"
  r = "sort_column_rank"
  s = "sort_column_symbol"
  space = "open_link"
  t = "sort_column_total_supply"
  u = "sort_column_last_updated"
  v = "sort_column_24h_volume"

List of actions

Action	Description
first_page	Go to first page
help	Show help
last_page	Go to last page
move_to_page_first_row	Move to first row on page
move_to_page_last_row	Move to last row on page
move_to_page_visible_first_row	Move to first visible row on page
move_to_page_visible_last_row	Move to last visible row on page
move_to_page_visible_middle_row	Move to middle visible row on page
move_up	Move one row up
move_down	Move one row down
next_page	Go to next page
open_link	Open row link
page_down	Move one row down
page_up	Scroll one page up
previous_page	Go to previous page
quit	Quit application
refresh	Do a manual refresh on the data
sort_column_1h_change	Sort table by column 1 hour change
sort_column_24h_change	Sort table by column 24 hour change
sort_column_24h_volume	Sort table by column 24 hour volume
sort_column_7d_change	Sort table by column 7 day change
sort_column_asc	Sort highlighted column by ascending order
sort_column_available_supply	Sort table by column available supply
sort_column_desc	Sort highlighted column by descending order
sort_column_last_updated	Sort table by column last updated
sort_column_market_cap	Sort table by column market cap
sort_column_name	Sort table by column name
sort_column_price	Sort table by column price
sort_column_rank	Sort table by column rank
sort_column_symbol	Sort table by column symbol
sort_column_total_supply	Sort table by column total supply
sort_left_column	Sort the column to the left of the highlighted column
sort_right_column	Sort the column to the right of the highlighted column
toggle_row_chart	Toggle the chart for the highlighted row

FAQ

• Q: Where is the data from?

  • A: The data is from Coin Market Cap.

• Q: What coins does this support?

  • A: This supports any coin listed on Coin Market Cap.

• Q: How often is the data polled?

  • A: Data gets polled once every minute by default.

• Q: I installed cointop without errors but the command is not found.

  • A: Make sure your GOPATH and PATH is set correctly.

    export GOPATH=$HOME/go
    export PATH=$PATH:$GOPATH/bin
    

• Q: What is the size of the binary?

  • A: The executable is only ~1.9MB in size.

Authors

• Miguel Mota

License

Released under the MIT license.