clipboard

README

Clipboard for Go

Provide copying, pasting and monitoring clipboard functionality for Go.

Build:

$ go get github.com/atotto/clipboard

Platforms:

• OSX
• Windows 7 (probably work on other Windows)
• Linux, Unix (requires 'xclip' or 'xsel' command to be installed)

Document:

• http://godoc.org/github.com/atotto/clipboard

Notes:

• Text string only
• UTF-8 text encoding only (no conversion)

Commands:

paste shell command:

$ go get github.com/atotto/clipboard/cmd/gopaste
$ # example:
$ gopaste > document.txt

copy shell command:

$ go get github.com/atotto/clipboard/cmd/gocopy
$ # example:
$ cat document.txt | gocopy

Documentation

Overview

Package clipboard read/write on clipboard

Example

package main

import (
	"fmt"

	"github.com/atotto/clipboard"
)

func main() {
	clipboard.WriteAll("日本語")
	text, _ := clipboard.ReadAll()
	fmt.Println(text)

}

Output:

日本語

Index

• Variables
• func Monitor(interval time.Duration, stopCh <-chan struct{}, changes chan<- string) error
• func ReadAll() (string, error)
• func WriteAll(text string) error

Examples

• Package

Variables

var (
	Primary bool
)

var Unsupported bool

Unsupported might be set true during clipboard init, to help callers decide whether or not to offer clipboard options.

Functions

func Monitor

func Monitor(interval time.Duration, stopCh <-chan struct{}, changes chan<- string) error

Monitor starts monitoring the clipboard for changes. When a change is detected, it is sent over the channel.

func ReadAll

func ReadAll() (string, error)

ReadAll read string from clipboard

func WriteAll

func WriteAll(text string) error

WriteAll write string to clipboard