# copy-paste-win32fix

> A command line utility that allows read/write (i.e copy/paste) access to the system clipboard.

Latest version **1.4.0** (published 2018-05-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install copy-paste-win32fix
pnpm add copy-paste-win32fix
yarn add copy-paste-win32fix
bun add copy-paste-win32fix
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.4.0 |
| Published | 2018-05-22 |
| First published | 2016-05-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 11.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Maintainers | notatestuser |
| Keywords | copy, paste, copy and paste, clipboard |

## Links

- npm: https://www.npmjs.com/package/copy-paste-win32fix
- Repository: https://github.com/notatestuser/node-copy-paste
- Homepage: https://github.com/notatestuser/node-copy-paste#readme
- Issues: https://github.com/notatestuser/node-copy-paste/issues
- npm.io page: https://npm.io/package/copy-paste-win32fix

## Dependencies (1)

- [iconv-lite](https://npm.io/package/iconv-lite.md) ^0.4.8

## Recent versions

- 1.4.0 (latest) — 2018-05-22
- 1.3.0 — 2016-12-19
- 1.2.0 — 2016-05-13

## README

# node-copy-paste

A command line utility that allows read/write (i.e copy/paste) access to the system clipboard.  It does this by wrapping [`pbcopy/pbpaste`](https://developer.apple.com/library/mac/#documentation/Darwin/Reference/Manpages/man1/pbcopy.1.html) (for OSX), [`xclip`](http://www.cyberciti.biz/faq/xclip-linux-insert-files-command-output-intoclipboard/) (for Linux, FreeBSD, and OpenBSD), and [`clip`](http://www.labnol.org/software/tutorials/copy-dos-command-line-output-clipboard-clip-exe/2506/) (for Windows). Currently works with node.js v0.8+.

## The API

When `require("copy-paste")` is executed, an object with the following properties is returned:

- `copy(text[, callback])`: asynchronously replaces the current contents of the clip board with `text`.  Takes either a string, array, object, or readable stream.  Returns the same value passed in. Optional callback will fire when the copy operation is complete.
- `paste([callback])`: if no callback is provided, `paste` synchronously returns the current contents of the system clip board.  Otherwise, the contents of the system clip board are passed to the callback as the second parameter.

	**Note**: The synchronous version of `paste` is not always availabled.  Unfortunately, I'm having a hard time finding a synchronous version of `child_process.exec` that consistently works on all platforms, especially windows.  An error message is shown if the synchronous version of `paste` is used on an unsupported platform.  That said, the asynchronous version of `paste` is always available.

- `require("copy-paste").global()`:  adds `copy` and `paste` to the global namespace.  Returns an object with `copy` and `paste` as properties.

## Example

```js
var ncp = require("copy-paste");

ncp.copy('some text', function () {
  // complete...
})
```

## Getting node-copy-paste

The easiest way to get node-copy-paste is with [npm](http://npmjs.org/):

	npm install -g copy-paste

Alternatively you can clone this git repository:

	git clone git://github.com/xavi-/node-copy-paste.git

## Future plans

I'm hoping to add various fallbacks for instances when `xclip` or `clip` is not avaiable (see [experimental-fallbacks](https://github.com/xavi-/node-copy-paste/tree/experimental-fallbacks/platform) branch).  Also this library needs to be more thoroughly tested on windows.

## Developed by
* Xavi Ramirez

## License
This project is released under [The MIT License](http://www.opensource.org/licenses/mit-license.php).

---
_Source: https://npm.io/package/copy-paste-win32fix · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._