https://github.com/lolcommits/lolcommits-twitter
Automatically tweet your lolcommits
https://github.com/lolcommits/lolcommits-twitter
fun git git-addons humor lolcommits lolcommits-plugin ruby selfie twitter
Last synced: 6 days ago
JSON representation
Automatically tweet your lolcommits
- Host: GitHub
- URL: https://github.com/lolcommits/lolcommits-twitter
- Owner: lolcommits
- License: lgpl-3.0
- Created: 2017-05-03T20:55:12.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2025-09-23T05:20:05.000Z (24 days ago)
- Last Synced: 2025-10-07T22:43:09.467Z (10 days ago)
- Topics: fun, git, git-addons, humor, lolcommits, lolcommits-plugin, ruby, selfie, twitter
- Language: Ruby
- Homepage: https://lolcommits.github.io
- Size: 69.3 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Lolcommits Twitter
[](http://rubygems.org/gems/lolcommits-twitter)
[](https://travis-ci.com/lolcommits/lolcommits-twitter)
[](https://depfu.com/github/lolcommits/lolcommits-twitter)
[](https://codeclimate.com/github/lolcommits/lolcommits-twitter/maintainability)
[](https://codeclimate.com/github/lolcommits/lolcommits-twitter/test_coverage)
[lolcommits](https://lolcommits.github.io/) takes a snapshot with your
webcam every time you git commit code, and archives a lolcat style image
with it. Git blame has never been so much fun!
This plugin automatically posts your Lolcommit to Twitter. The tweet
features your commit message (shortened, with some optional surrounding
text) and the captured image. See the
[#lolcommits](https://twitter.com/hashtag/lolcommits) hash tag for some
examples in the wild. You can also configure the plugin to auto-open the
tweet in your default browser.
## Requirements
* Ruby >= 2.4
* A webcam
* [ImageMagick](http://www.imagemagick.org)
* [ffmpeg](https://www.ffmpeg.org) (optional) for animated gif capturing
## Installation
After installing the lolcommits gem, install this plugin with:
$ gem install lolcommits-twitter
The configure the plugin to enable it and auth with Twitter
$ lolcommits --config -p twitter
# set enabled to `true` (then set your own options or choose the defaults)
*NOTE*: if you enable this plugin on another repository you may want to
copy the credentials from `~/.lolcommits/{your-repo}/config.yml` (so
Twitter does not de-authorize the connection).
### Configuration
The following options are available:
* prefix
* suffix (default: #lolcommits)
* auto-open tweet url?
You can always reconfigure the plugin later, to change these options
without having to re-authenicate with Twitter.
To disable - set `enabled: false` and revoke plugin access to your
twitter account [here](https://twitter.com/settings/applications).
## Development
Check out this repo and run `bin/setup`, to install all dependencies and
generate docs. Run `bundle exec rake` to run all tests and generate a
coverage report.
You can also run `bin/console` for an interactive prompt that will allow
you to experiment with the gem code.
## Tests
MiniTest is used for testing. Run the test suite with:
$ rake test
## Docs
Generate docs for this gem with:
$ rake rdoc
## Troubles?
If you think something is broken or missing, please raise a new
[issue](https://github.com/lolcommits/lolcommits-twitter/issues). Take a
moment to check it hasn't been raised in the past (and possibly closed).
## Contributing
Bug [reports](https://github.com/lolcommits/lolcommits-twitter/issues)
and [pull
requests](https://github.com/lolcommits/lolcommits-twitter/pulls) are
welcome on GitHub.
When submitting pull requests, remember to add tests covering any new
behaviour, and ensure all tests are passing on [Travis
CI](https://travis-ci.com/lolcommits/lolcommits-twitter). Read the
[contributing
guidelines](https://github.com/lolcommits/lolcommits-twitter/blob/master/CONTRIBUTING.md)
for more details.
This project is intended to be a safe, welcoming space for
collaboration, and contributors are expected to adhere to the
[Contributor Covenant](http://contributor-covenant.org) code of conduct.
See
[here](https://github.com/lolcommits/lolcommits-twitter/blob/master/CODE_OF_CONDUCT.md)
for more details.
## TODO
- [ ] Support uploading lolcommit videos
- [ ] Refactor Client to include Request/Response classes (see twitter gem approach)
- [ ] Tests for Client lib classes
- [ ] Tests for Plugin class (port tests from lolcommits)
- [ ] Test running `capture_ready` method (stub with webmock?)
- [ ] Correctly stub out launcher, or have it do nothing in tests
- [ ] Update README
- [ ] Check gem dependencies are correct
## License
The gem is available as open source under the terms of
[LGPL-3](https://opensource.org/licenses/LGPL-3.0).
## Links
* [Travis CI](https://travis-ci.com/lolcommits/lolcommits-twitter)
* [Test Coverage](https://codeclimate.com/github/lolcommits/lolcommits-twitter/test_coverage)
* [Code Climate](https://codeclimate.com/github/lolcommits/lolcommits-twitter)
* [RDoc](http://rdoc.info/projects/lolcommits/lolcommits-twitter)
* [Issues](http://github.com/lolcommits/lolcommits-twitter/issues)
* [Report a bug](http://github.com/lolcommits/lolcommits-twitter/issues/new)
* [Gem](http://rubygems.org/gems/lolcommits-twitter)
* [GitHub](https://github.com/lolcommits/lolcommits-twitter)