Available on RubyGems.org at https://rubygems.org/gems/slack_pomodoro_timer
A Ruby powered command line app for sending timed messages to slack channels
Install the gem
$ gem install slack_pomodoro_timer
Configure your Slackbot URL
Configure the Slackbot URL:
$ slack_pomodoro_timer config --url https://company.slack.com/services/hooks/slackbot?token=YOUR_TOKEN_HERE
Not sure where to find your Slackbot URL?
Make sure you are signed into your Slack team at https://slack.com/signin
Then go to this link https://slack.com/apps/build
Click on the 'Configure' button in the top right
Now choose 'Custom Integrations'
If you do not have any Slackbot integrations you'll have to create one, otherwise skip this step and the next
Click 'Add Configuration' then 'Add Slackbot Configuration'
You should see an edit button next to your created integration as a pencil icon, click it!
Scroll down to 'Setup Instructions' and copy the full URL that you see under 'Your slackbot URL is:'
Now paste that URL into the above command to configure the URL for Slack Pomodoro Timer
You should now be able to run
$ slack_pomodoro_timer start 1! See below for changing the channel.
NOTE: Slack Pomodoro Timer is actually able to accept a Webhook URL as well, however this functionality is not fully tested at this time.
Configure the channel
Slack Pomodoro Timer is configured to send messages to the 'general' channel by default. If you want to send messages to another channel you'll have to configure it will that channel.
Configure the channel into which you would like to post (this defaults to the general channel):
$ slack_pomodoro_timer config --channel my_channel
You do not need to prepend your channel name with a # symbol, but if you absolutely must, then make sure to wrap your channel name in quotes:
$ slack_pomodoro_timer config --channel "#my_channel"
To run 5 consecutive 25 minute Pomodoros:
$ slack_pomodoro_timer start 5
Here's how to use a custom pomodoro time length:
$ slack_pomodoro_timer start 5 --minutes 10
For help on command options and usage use the following syntax:
$ slack_pomodoro_timer help config $ slack_pomodoro_timer help start
Still a work in progress, however there are minimal passing tests.
To run the tests you can simply run
$ rspec or use Guard with
$ bundle exec guard.
After checking out the repo, run
bin/setup to install dependencies. Then, run
rake spec to run the tests. You can also run
bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run
bundle exec rake install. To release a new version, update the version number in
version.rb, and then run
bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the
.gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub https://github.com/BideoWego/slack_pomodoro_timer
The gem is available as open source under the terms of the MIT License.