{"id":13936178,"url":"https://github.com/djudman/evernote-telegram-bot","last_synced_at":"2025-07-19T21:31:57.943Z","repository":{"id":37548650,"uuid":"56721930","full_name":"djudman/evernote-telegram-bot","owner":"djudman","description":"Telegram bot for Evernote","archived":false,"fork":false,"pushed_at":"2023-07-20T15:40:09.000Z","size":729,"stargazers_count":55,"open_issues_count":5,"forks_count":16,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-27T04:30:44.091Z","etag":null,"topics":["evernote","python","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/evernoterobot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/djudman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-04-20T21:23:19.000Z","updated_at":"2024-10-31T10:35:36.000Z","dependencies_parsed_at":"2024-04-27T23:48:55.432Z","dependency_job_id":"3630d709-c19a-4567-854e-806eaa758bd4","html_url":"https://github.com/djudman/evernote-telegram-bot","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/djudman/evernote-telegram-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djudman%2Fevernote-telegram-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djudman%2Fevernote-telegram-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djudman%2Fevernote-telegram-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djudman%2Fevernote-telegram-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/djudman","download_url":"https://codeload.github.com/djudman/evernote-telegram-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djudman%2Fevernote-telegram-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266019657,"owners_count":23864916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["evernote","python","telegram","telegram-bot"],"created_at":"2024-08-07T23:02:26.349Z","updated_at":"2025-07-19T21:31:52.930Z","avatar_url":"https://github.com/djudman.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"Telegram bot for Evernote\n=========================\n[![Coverage Status](https://coveralls.io/repos/github/djudman/evernote-telegram-bot/badge.svg?branch=master)](https://coveralls.io/github/djudman/evernote-telegram-bot?branch=master)\n[![Maintainability](https://api.codeclimate.com/v1/badges/1d23d48c1a7370b7b12f/maintainability)](https://codeclimate.com/github/djudman/evernote-telegram-bot/maintainability)\n\nThis bot can save to your Evernote everything that you send.\n\nYou can use this bot in Telegram: https://t.me/evernoterobot  \n*Or* you can use **your own** telegram bot and your own server, then see [Installation](#Installation)\n\n# Installation\nIf you have some reasons do not use my bot deployed on my server, you can use\nyour own installation.  \n\n* Create your bot with the\n[BotFather](https://telegram.me/BotFather)\n(see https://core.telegram.org/bots#3-how-do-i-create-a-bot)\n* Create Evernote application and obtain a pair of keys (access key and access secret) \n    * Go to https://dev.evernote.com/doc/ and press the green button *\"GET AN API KEY\"*\n* Install a Docker to your server (see https://docs.docker.com/install/)\n* Get and set up SSL certificate (see https://letsencrypt.org)\n* Set up [nginx](https://nginx.org)/[caddy](https://caddyserver.com)/another proxy server to work with your SSL certificate.\n* Check you have *[curl](https://curl.haxx.se/download.html)* on your server (usually it's installed by default)\n* Execute this command: `sudo curl https://raw.githubusercontent.com/djudman/evernote-telegram-bot/master/evernotebot-install.sh --output evernotebot-install.sh \u0026\u0026 sh evernotebot-install.sh`\n    * `sudo` is needed because there is copying a file to `/etc/init.d` directory\n    * you will need to enter some data as:\n        * telegram api token\n        * evernote access key\n        * evernote access secret\n        * etc., see [Environment variables](#Environment-variables)\n* Execute `/etc/init.d/evernotebot start` to start bot\n\n## How to build docker image manually\n\n* Clone source code to your server\n    ```\n    git clone https://github.com/djudman/evernote-telegram-bot.git\n    ```\n* Build image\n    ```\n    docker build -t evernote-telegram-bot .\n    ```\n* Define [environment variables](#Environment-variables) (for example, in `.bashrc`)\n* Create a docker volume to store data\n    `docker volume create evernotebot-data`\n* Run a container\n    ```\n    docker run \\\n        -e EVERNOTEBOT_DEBUG=\"$EVERNOTEBOT_DEBUG\" \\\n        -e EVERNOTEBOT_HOSTNAME=\"$EVERNOTEBOT_HOSTNAME\" \\\n        -e EVERNOTEBOT_EXPOSE_PORT=\"$EVERNOTEBOT_EXPOSE_PORT\" \\\n        -e TELEGRAM_API_TOKEN=\"$TELEGRAM_API_TOKEN\" \\\n        -e TELEGRAM_BOT_NAME=\"$TELEGRAM_BOT_NAME\" \\\n        -e EVERNOTE_READONLY_KEY=\"$EVERNOTE_READONLY_KEY\" \\\n        -e EVERNOTE_READONLY_SECRET=\"$EVERNOTE_READONLY_SECRET\" \\\n        -e EVERNOTE_READWRITE_KEY=\"$EVERNOTE_READWRITE_KEY\" \\\n        -e EVERNOTE_READWRITE_SECRET=\"$EVERNOTE_READWRITE_SECRET\" \\\n        -d \\\n        -p 127.0.0.1:8000:8000 \\\n        --restart=always \\\n        --name=evernotebot \\\n        -it \\\n        -v ./logs:/app/logs:rw \\\n        --mount source=\"evernotebot-data\",target=\"/evernotebot-data\" \\\n        evernote-telegram-bot\n    ```\n\n# Environment variables\n| Variable name             | Default value         | Description                                                                                                  |\n|---------------------------|-----------------------|--------------------------------------------------------------------------------------------------------------|\n| EVERNOTEBOT_DIR           | $HOME/evernotebot     | Install dir for tha bot. Some files there. For example, `logs/` dir and `.env` file                          |\n| EVERNOTEBOT_DEBUG         | 0                     | Enable debug mode (additional logging, use evernote sandbox)                                                 |\n| EVERNOTEBOT_HOSTNAME      | evernotebot.djud.site | DNS name of your host. This name will use in such URLs as oauth callback url and webhook url                 |\n| EVERNOTEBOT_EXPOSE_PORT   | 8000                  | Port that the docker container with bot listen on your machine. The bot inside container uses 127.0.0.1:8000 |\n| TELEGRAM_BOT_NAME         | evernoterobot         | Name of telegram bot. You used this in BotFather                                                             |\n| TELEGRAM_API_TOKEN        | -                     | Access token for telegram API. You can obtain this by BotFather                                              |\n| EVERNOTE_READONLY_KEY     | -                     | appKey for your Evernote app (readonly permissions)                                                          |\n| EVERNOTE_READONLY_SECRET  | -                     | secret for your Evernote app (readonly permissions)                                                          |\n| EVERNOTE_READWRITE_KEY    | -                     | appKey for your Evernote app (read/write permissions), required for `one_note` bot mode                      |\n| EVERNOTE_READWRITE_SECRET | -                     | secret for your Evernote app (read/write permissions), required for `one_note` bot mode                      |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjudman%2Fevernote-telegram-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjudman%2Fevernote-telegram-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjudman%2Fevernote-telegram-bot/lists"}