Skip to content

About

No description, website, or topics provided.

Resources

Stars

9 stars

Watchers

2 watching

Forks

Latest commit

 

History

55 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ctrl+C 2 Are.na

Simple Go utility that monitors the Clipboard. Whenever you Ctrl+C it sends the copied text to the specified channel in your Are.na profile.

CtrlC2Arena

Download

You don't need Go or the source code to use the app. Download the ready-made executable for macOS, Windows or Linux from the Releases page, unzip it and run it.

Things you need

  • An Are.na account.
  • An Are.na personal access token with Read and Write permission (https://www.are.na/settings/personal-access-tokens). A read-only token won't let the app add blocks to your channel. The app uses the Are.na API v3.
  • The slug of the channel you want to feed (as of https://www.are.na/{your-profile}/{your-channel}).
  • Go (https://go.dev/), only if you want to run or develop the source code. Inside the folder execute in the console go run .

Where your token is stored

Nothing is saved unless you tick "Remember token and channel on this computer" before starting. When you do, the token and the channel slug are stored separately:

The token goes into your operating system's password manager. It is never written to a file by this app, and the app does not encrypt it itself — the operating system does, tied to your user login. This is the same place browsers and other apps keep their passwords.

System Where the token is kept How to see or delete it
macOS Login keychain, as a password item named "Ctrl+C to Are.na" (account personal-access-token) Open Keychain Access and search for "Ctrl+C"
Windows Credential Manager, under Windows Credentials, as Ctrl+C to Are.na:personal-access-token Control Panel → Credential Manager → Windows Credentials
Linux The Secret Service keyring (GNOME Keyring, KWallet, or similar), as a secret labelled "Password for 'personal-access-token' on 'Ctrl+C to Are.na'" Seahorse ("Passwords and Keys") or your desktop's wallet manager

macOS might not ask you for permission when the app saves the token; the item simply appears in your login keychain.

On Linux, a Secret Service daemon must be running. If there isn't one, the app still works but shows a red note under "Listening" saying the token couldn't be remembered, and you'll have to enter it again next time. It will not fall back to a plain-text file.

Only the channel slug goes into a file, readable by your user account alone:

  • macOS: ~/Library/Application Support/ctrlc2arena/settings.json
  • Windows: %AppData%\ctrlc2arena\settings.json
  • Linux: ~/.config/ctrlc2arena/settings.json

The file contains just {"slug":"your-channel"}; the token is never in it.

To forget everything, untick the checkbox and press "Start listening" once. The app removes the token from the password manager and deletes the settings file. You can also delete the keychain item by hand using the table above.

Upgrading from an older version: earlier releases saved the token in plain text in a file called arena_settings.json next to the app. On first launch, the new version moves its contents into the storage described above and deletes that file. If the token can't be moved (for example, no keyring on Linux), the old file is left untouched so nothing is lost — delete it by hand once you've re-entered the token.

What gets sent

While the app is listening, every text you copy becomes a block in your channel. Two safeguards catch the most common slips, but neither is a reason to leave it listening while you work with anything private.

  • Copies from password managers are ignored. On macOS and Windows, password managers mark what they copy as concealed, and the app skips those copies: they're neither sent nor shown in the preview. Linux has no such mark, so this doesn't apply there.
  • Text that looks like a key or token is held back. API keys and tokens from common services, private keys, passwords inside web addresses, and lone random-looking strings aren't sent. Instead of a preview, the app says "Looks like a secret, so it wasn’t sent." This is a guess from the shape of the text: a quote or a sentence is never held back, and a secret that doesn't look like one will get through.

Both safeguards are always on; there is no way to turn them off. Whatever you collect ends up in the channel you chose, and open channels can be read by anyone. If you collect anything sensitive, feed a private channel, which only you can see.

Stopping automatically

Listening stops by itself after 30 minutes without a new copy, so the app isn't left watching the clipboard once you've put the book down. Every copy restarts the count, including ones that were held back or failed to send. When it stops, the window goes back to the start screen and says so: "Stopped after 30 minutes without copies."

The row under "Remember token and channel" controls this. Untick "Stop listening after" to keep listening until you stop it yourself, or change the number of minutes, from 1 to 720 (twelve hours). The choice is remembered along with the channel when that checkbox is ticked.

Holding before sending

Normally each copy goes to your channel straight away. If you'd rather have a moment to catch a copy you didn't mean to share, tick "Hold before sending" and choose how many seconds to wait, from 1 to 30 (5 to begin with). While a copy waits, the preview shows it with "Sending in 5 s…" counting down and an Undo button next to it. Pressing Undo, or the Esc key, drops that copy: nothing reaches Are.na. Each copy waits on its own, so copying twice in a row holds both and Undo takes back the latest. Stopping listening drops whatever is still waiting and says so under the preview.

The hold is off unless you turn it on. Like the timer, it's remembered along with the channel when "Remember token and channel on this computer" is ticked. Text that looks like a secret is held back before any of this, so it never waits to be sent.

Build

go build automatically detects your current operating system and architecture to build for that target by default. However, Go also supports cross-compilation, allowing you to build for different platforms by setting the GOOS and GOARCH environment variables.

For Windows, this command should work: go build -ldflags="-H=windowsgui" -o ctrl2arena.exe

For cross-compilation examples:

# Build for Windows from any OS
GOOS=windows GOARCH=amd64 go build -ldflags="-H=windowsgui" -o ctrl2arena.exe

# Build for Linux
GOOS=linux GOARCH=amd64 go build -o ctrl2arena

# Build for macOS
GOOS=darwin GOARCH=amd64 go build -o ctrl2arena

You can see all supported target combinations with: go tool dist list

The About dialog shows the version the app was built with. Releases take it from the git tag; for your own builds, pass it with -ldflags "-X main.version=2.1.0" (any text works). Without the flag the dialog says "Development build".

Publishing a release

Releases are built and published by GitHub Actions. Versions follow semantic versioning: bump the first number when users must change something, the second for new features, the third for fixes.

  1. Add a ## vX.Y.Z section to the top of CHANGELOG.md describing the changes. Its contents become the release notes.

  2. Commit, then tag and push:

    git tag -a vX.Y.Z -m "vX.Y.Z"
    git push origin main --tags

The workflow builds the three platforms and creates the release with the zips attached. It fails on purpose if CHANGELOG.md has no section for the tag.

Use case

I like to read and collect information in my Are.na from books and stuff. I also find tedious to copy/paste it each time. So now this tool automatically does it for me, and I can save important notes outside my main computer. This has made my research easier and funnier.

Collaboration

Please, feel free to fork and enhance the current code so it becomes easier and beautiful to use!

To report a problem or suggest something, open an issue. The About button in the app's bottom-right corner links there too.

Are.na logo Go Gopher in a biplane


Built with ❤️ using Go and the Are.na API

About

No description, website, or topics provided.

Resources

Stars

9 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages