aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDaniel Byron <=>2015-07-17 17:37:57 +1000
committerDaniel Byron <=>2015-07-17 17:37:57 +1000
commita9f15e2c2a670f9796a0e898fa6cf39fb79e579f (patch)
tree46f5255463c45e93e2e2eb35faca978caebe1067 /README.md
downloadschemer2-a9f15e2c2a670f9796a0e898fa6cf39fb79e579f.tar.xz
schemer2-a9f15e2c2a670f9796a0e898fa6cf39fb79e579f.zip
Moved from Bitbucket to Github
Diffstat (limited to 'README.md')
-rw-r--r--README.md86
1 files changed, 86 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8f2134e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,86 @@
+# UNDER CONSTRUCTION
+
+Various aspects of this program are still being developed. Command line usage is quite probably going to change somewhat from as it is now.
+
+Terminal Colorscheme Generator
+==============================
+
+## Screenshot
+![Screenshot](http://i.imgur.com/TSLluID.png)
+
+## Installation
+
+### AUR
+
+There is now an AUR package for schemer at https://aur.archlinux.org/packages/schemer/
+
+### Short version
+
+> go get github.com/thefryscorer/schemer
+
+### Long Version
+
+#### Installing and configuring Go
+To build this program, you will need to have Go installed and properly configured. After installing the Go package, you will need to configure a GOPATH. This is a directory in which Go will keep its programs and source files. I recommend making the GOPATH directory in your home folder. If your GOPATH is in your root directory a kitten will die.
+
+> mkdir ~/Go
+
+You will also need to set the GOPATH variable so that Go knows where to put things. You can do this by running:
+
+> export GOPATH=$HOME/Go
+
+NOTE: You don't need to (and shouldn't) set the $GOROOT variable. This is handled for you and you shouldn't mess with it.
+
+#### Installing SDL1.2
+This program also makes use of SDL1.2 for the color preview window (which you can use by adding the "-d" flag in schemer). As such, SDL1.2 will need to be installed on your system for you to build and run schemer.
+
+**To install SDL1.2 in ArchLinux:**
+
+> sudo pacman -S sdl sdl_image sdl_ttf sdl_mixer
+
+**To install SDL1.2 in Mac OS:**
+
+> brew install sdl sdl_image sdl_ttf sdl_mixer
+
+If you haven't installed HomeBrew, you can find it at http://brew.sh
+
+
+**To install SDL1.2 on another system:**
+
+Learn how to use Google and your package manager. Both are very useful.
+
+#### Installing schemer
+You should now be able to install schemer using the command:
+
+> go get github.com/thefryscorer/schemer
+
+And it will be built in your GOPATH directory, in a subdirectory named 'bin'. To run it, you can either add $HOME/Go/bin to your system path and run it as you would any other command. Or cd into the bin directory and run it with:
+
+> ./schemer
+
+## Usage
+
+> schemer -term="xfce" Image.png
+
+Then copy the generated config lines into your terminal config file.
+
+## Features
+
+- Outputs configuration in several different formats for different terminals.
+- Configurable color difference threshold
+- Configurable minimum and maximum brightness value
+- Can preview colorscheme in SDL window
+
+## Supported output formats
+
+- Colours in just plain text (default)
+- Konsole
+- xterm/rxvt/aterm
+- urxvt
+- iTerm2
+- XFCE Terminal
+- Roxterm
+- LilyTerm
+- Terminator
+- Chrome Shell
+- OS X Terminal