From c57bbb8cba359a789e78cad9e267ca062740e400 Mon Sep 17 00:00:00 2001 From: Kevin Chabowski Date: Tue, 4 Mar 2014 13:34:08 +0100 Subject: A better README --- README.markdown | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 README.markdown (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown new file mode 100644 index 0000000..346d386 --- /dev/null +++ b/README.markdown @@ -0,0 +1,31 @@ +A simple start page with a background image from [/r/EarthPorn](http://www.reddit.com/r/earthporn), weather from [yr.no](http://www.yr.no) and customizable links. + +## Screenshot +![Screenshot](http://i.imgur.com/u42QOZe.png) + +## Installation + +`go get github.com/kch42/startpage` + +## Configuration + +startpage uses two files in your home directory for configuration: + +### ~/.startpage-urls + +This describes the hyperlinks that are displayed on the startpage. A list of key-value-pairs. Each line is such a pair. Key and value are separated with `->`. The key is the title of the link, the value the URL. + +Example: + + github -> http://www.github.com + reddit -> http://www.reddit.com + go -> http://www.golang.org + example -> http://www.example.org + +### ~/.startpage-weather + +The place for the weather is stored here. startpage uses [yr.no](http://www.yr.no) to get weather data. Use the search box on that page to search for your place. You will then be redirected to an URL like this: `http://www.yr.no/place/`. Put the `` part into the `.startpage-weather` file. + +## Running + +If `$GOPATH/bin` is in your `$PATH`, you can run startpage with the command `startpage`. By default, startpage listens on port 25145. You can change that with a command line switch: `startpage -laddr :` \ No newline at end of file -- cgit v1.2.3-70-g09d2