# drone-telegram [](https://godoc.org/github.com/appleboy/drone-telegram) [](https://cloud.drone.io/appleboy/drone-telegram) [](https://ci.appveyor.com/project/appleboy/drone-telegram) [](https://codecov.io/gh/appleboy/drone-telegram) [](https://goreportcard.com/report/github.com/appleboy/drone-telegram) [](https://hub.docker.com/r/appleboy/drone-telegram/) [](https://microbadger.com/images/appleboy/drone-telegram "Get your own image badge on microbadger.com") [Drone](https://github.com/drone/drone) plugin for sending telegram notifications. For the usage information and a listing of the available options please take a look at [the docs](http://plugins.drone.io/appleboy/drone-telegram/). ## Feature * [x] Send with Text Message. (`markdown` or `html` format) * [x] Send with New Photo. * [x] Send with New Document. * [x] Send with New Audio. * [x] Send with New Voice. * [x] Send with New Location. * [x] Send with New Venue. * [x] Send with New Video. * [x] Send with New Sticker. ## Build or Download a binary The pre-compiled binaries can be downloaded from [release page](https://github.com/appleboy/drone-telegram/releases). Support the following OS type. * Windows amd64/386 * Linux arm/amd64/386 * Darwin amd64/386 With `Go` installed ``` $ go get -u -v github.com/appleboy/drone-telegram ``` or build the binary with the following command: ``` $ export GOOS=linux $ export GOARCH=amd64 $ export CGO_ENABLED=0 $ export GO111MODULE=on $ go test -cover ./... $ go build -v -a -tags netgo -o release/linux/amd64/drone-telegram . ``` ## Testing Test the package with the following command: ``` $ make test ``` ## Docker Build the docker image with the following commands: ``` $ make docker ``` Please note incorrectly building the image for the correct x64 linux and with GCO disabled will result in an error when running the Docker image: ``` docker: Error response from daemon: Container command '/bin/drone-telegram' not found or does not exist.. ``` ## Usage Execute from the working directory: ```sh docker run --rm \ -e PLUGIN_TOKEN=xxxxxxx \ -e PLUGIN_TO=xxxxxxx \ -e PLUGIN_MESSAGE=test \ -e PLUGIN_PHOTO=tests/github.png \ -e PLUGIN_DOCUMENT=tests/gophercolor.png \ -e PLUGIN_STICKER=tests/github-logo.png \ -e PLUGIN_AUDIO=tests/audio.mp3 \ -e PLUGIN_VOICE=tests/voice.ogg \ -e PLUGIN_LOCATION="24.9163213 121.1424972" \ -e PLUGIN_VENUE="24.9163213 121.1424972 title address" \ -e PLUGIN_VIDEO=tests/video.mp4 \ -e PLUGIN_DEBUG=true \ -e PLUGIN_ONLY_MATCH_EMAIL=false \ -e PLUGIN_FORMAT=markdown \ -e DRONE_REPO_OWNER=appleboy \ -e DRONE_REPO_NAME=go-hello \ -e DRONE_COMMIT_SHA=e5e82b5eb3737205c25955dcc3dcacc839b7be52 \ -e DRONE_COMMIT_BRANCH=master \ -e DRONE_COMMIT_LINK=https://github.com/appleboy/go-hello/compare/master... \ -e DRONE_COMMIT_AUTHOR=appleboy \ -e DRONE_COMMIT_AUTHOR_EMAIL=appleboy@gmail.com \ -e DRONE_BUILD_NUMBER=1 \ -e DRONE_BUILD_STATUS=success \ -e DRONE_BUILD_LINK=http://github.com/appleboy/go-hello \ -e DRONE_TAG=1.0.0 \ -e DRONE_JOB_STARTED=1477550550 \ -e DRONE_JOB_FINISHED=1477550750 \ -v $(pwd):$(pwd) \ -w $(pwd) \ appleboy/drone-telegram ``` Load all environments from file. ```bash docker run --rm \ -e ENV_FILE=your_env_file_path \ -v $(pwd):$(pwd) \ -w $(pwd) \ appleboy/drone-telegram ```