-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
baf9910
commit 466de86
Showing
8 changed files
with
140 additions
and
134 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -7,11 +7,7 @@ | |
- [How to Use?](#how-to-use) | ||
- [How to Run?](#how-to-run) | ||
- [macOS/Linux using Homebrew/Linuxbrew (recommend)](#macoslinux-using-homebrewlinuxbrew-recommend) | ||
- [Easily run the tool via Docker](#easily-run-the-tool-via-docker) | ||
- [Non-Docker Setup](#non-docker-setup) | ||
- [Install `go`](#install-go) | ||
- [Install the tool (optional)](#install-the-tool-optional) | ||
- [Run the tool](#run-the-tool) | ||
- [Other Ways](#other-ways) | ||
- [Setting up the environment for Google Calendar Sync](#setting-up-the-environment-for-google-calendar-sync) | ||
- [Features/Issues to be worked upon](#featuresissues-to-be-worked-upon) | ||
- [Contributing towards development](#contributing-towards-development) | ||
|
@@ -22,6 +18,8 @@ | |
|
||
![release](https://img.shields.io/github/v/release/goyalmunish/reminder) | ||
![go_version](https://img.shields.io/github/go-mod/go-version/goyalmunish/reminder) | ||
![build](https://img.shields.io/github/actions/workflow/status/goyalmunish/reminder/ci.yml?label=build) | ||
![release](https://img.shields.io/github/actions/workflow/status/goyalmunish/reminder/release.yml?label=release) | ||
![license](https://img.shields.io/github/license/goyalmunish/reminder) | ||
|
||
## Yet Another Reminder Tool/App. Why? | ||
|
@@ -128,107 +126,9 @@ brew upgrade goyalmunish/reminder/reminder | |
|
||
The brew tap is maintained at [goyalmunish/homebrew-reminder](https://github.com/goyalmunish/homebrew-reminder). | ||
|
||
### Easily run the tool via Docker | ||
### Other Ways | ||
|
||
_This is the easiest way to get going, if you have [Docker](https://docs.docker.com/get-docker/) installed. Just download the [`reminder` image](https://hub.docker.com/r/goyalmunish/reminder/tags) by issuing the following commands:_ | ||
|
||
_**Using Script:**_ | ||
|
||
Make sure first to clone the repo and `cd` into it. | ||
|
||
```sh | ||
# pull latest reminder image, make sure ~/reminder directory exists, and run the tool | ||
. ./scripts/run_via_docker.sh | ||
|
||
# run the tool (just run, without pulling image and other initialization steps) | ||
. ./scripts/run_via_docker.sh fast | ||
``` | ||
|
||
_**Using Direct Way:**_ | ||
|
||
```sh | ||
# pull the image (or get the latest image) | ||
docker pull goyalmunish/reminder | ||
|
||
# make sure the directory for the data file exists on the host machine | ||
mkdir -p ~/reminder | ||
|
||
# spin up the container, with data file shared from the host machine | ||
docker run -it --rm --name reminder -v ~/reminder:/root/reminder goyalmunish/reminder | ||
``` | ||
|
||
_For subsequent runs, better add the below alias to `~/.bashrc` ( or `~/.zshrc`, etc), so that you can invoke the tool, just by typing `reminder` (or any other alias that you prefer):_ | ||
|
||
```sh | ||
# define the alias | ||
alias reminder='docker run -it --rm --name reminder -v ~/reminder:/root/reminder goyalmunish/reminder' | ||
``` | ||
|
||
_Then, run the tool using `reminder` command._ | ||
|
||
### Non-Docker Setup | ||
|
||
Check for available installers on [**releases**](https://github.com/goyalmunish/reminder/releases) page. Otherwise, | ||
|
||
#### Install `go` | ||
|
||
On Mac, you can just install it with `brew` as: | ||
|
||
```sh | ||
brew install [email protected] | ||
``` | ||
|
||
_For other platforms, check [official `go` download and install guide](https://go.dev/dl/)._ | ||
|
||
Check installed version: | ||
|
||
```sh | ||
go version | ||
``` | ||
|
||
#### Install the tool (optional) | ||
|
||
Clone the repo: | ||
|
||
```sh | ||
git clone [email protected]:goyalmunish/reminder.git | ||
``` | ||
|
||
If this results in Permission issues, such as `[email protected]: Permission denied (publickey).`, then either you [Setup Git](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup) or just use `git clone https://github.com/goyalmunish/reminder.git` instead. | ||
|
||
Install the tool as: | ||
|
||
```sh | ||
# cd into the local copy of the repo | ||
cd reminder | ||
|
||
# install the tool | ||
go install ./cmd/reminder | ||
|
||
# move the binary to /usr/local/bin/ | ||
mv ${GOPATH}/bin/reminder /usr/local/bin/reminder | ||
``` | ||
|
||
#### Run the tool | ||
|
||
If you have installed the tool, and your `go/bin` path is alreay in `PATH`, then you can just run it as: | ||
|
||
```sh | ||
reminder | ||
``` | ||
|
||
Otherwise, you can just run it as (without installing, directly from clone of the repo): | ||
|
||
```sh | ||
# cd into the local copy of the repo | ||
cd reminder | ||
|
||
# running the tool using `make` | ||
make run | ||
|
||
# or as | ||
go run ./cmd/reminder | ||
``` | ||
Refer [Other Ways of Running](./readme_extension.md#other-ways-of-running). | ||
|
||
## Setting up the environment for Google Calendar Sync | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.