Skip to content

command line program to add tasks to an Everdo inbox

License

Notifications You must be signed in to change notification settings

bodemann/everdoadd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

everdoadd (ea)

everdoadd (ea) is a cmd line program to add tasks to the Everdo inbox. Everdo is a cross-platform GTD app.

Licensed under MIT

Examples

  • ea Fitness Add a task named "Fitness" without a descrition to Everdo inbox.
  • ea Vacation Plan vacation for the family Add a task "Vacation" and the description Plan vacation...
  • ea --help Prints everdoadd help information
  • ea --debug Print debug information. CAUTION: prints IP address and API-key to stdout.

Quickstart

This is meant for experienced users:

  • copy precompiled executable into your $PATH and rename it to ea
  • activate API in Everdo settings and set an API key (on restart Everdo will set one if the field is empty)
  • use env variable EVERDO_API_KEY to set the API key for everdoadd (ea)
  • if you want to add tasks from a differenct computer
    • set IP/Hostname in the Everdo settings (default is localhost:11111)
    • set env variable EVERDO_IP_ADDRESS to the same value, don't forget the port (e.g. 192.168.10.1:12344)
  • restart everdo to activate the api

Installation

The binary name for everdoadd is ea.

Linux, Windows and macOS binaries are static executables. All platforms where the Go programming language is available should be supported. Only Linux and macOS are tested. Bug reports and feature requests and general feedback are welcome.

Precompiled binaries

You find precompiled versions for Linux, Windows and macOS here Copy the executable to a directory in your PATH and rename it to ea.

Building from source

everdoadd is written in Go, so you'll need a Go installation in order to compile it. everdoadd was build with Go 1.21 (stable) but should compile with earlier versions after changing go.mod respectively. Future versions will use the latest stable Go version.

Configuration

Configure Everdo

Everdo must be configured to allow external tools adding tasks into the inbox.

Configure everdoadd

everdoadd needs to know the IP address and the API-key of your Everdo program to work. everdoadd gets this information from two environment variables named EVERDO_IP_ADDRESS and EVERDO_API_KEY respectively.

EVERDO_API_KEY is necessary. EVERDO_IP_ADDRESS needs to be set only if the default localhost:11111 should not be used.

Here are links to information how to set environment variables for Window, Linux and macOS.

Usage

Command Description
ea Workout creates an entry with title "Workout" in everdos inbox.
ea Workout Upper body and legs creates an entry with title "Workout" and a description: "Upper body..."
ea "Workout at the beach" Upper body and legs creates an entry with title "Workout at the beach" and a description: "Upper body..."
ea --debug CAUTION: prints IP address and API-key to stdout
ea --help prints a help text
ea --version prints version information

About

command line program to add tasks to an Everdo inbox

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages