Mytotp
Another TOTP cli app. Nice UI, simple to use and user-friendly.
Main features
- Add, remove and update services.
- Configure period(code's duration) and number of digits(code's length).
- Generate a TOTP.
- Copy to clipboard the generated TOTP.
- Generating codes in continuos mode.
Installation
Install the gem by executing:
gem install mytotp
For the copy to clipboard functionality the third party gem say:
Important note for Linux users: The clipboard requires the xsel or the xclip command-line program. On debian and ubuntu, xsel can be installed with: sudo apt-get install xsel
Usage
For help on how to use:
mytotp -h
Add a service
For add a new service use:
mytotp service add [Service] [Username] [Key] [Period] [Digits]
If you don't want to pass all arguments just leave blank and the interactive mode ask to you the necesary information.
Remove a service
For remove a service use:
mytotp service remove [Service] [Username]
If you don't want to pass all arguments just leave blank and the interactive mode ask to you the necesary information.
Generate a TOTP
For generate use:
mytotp generate [Service] [Username]
If you don't want to pass all arguments just leave blank and the interactive mode ask to you the necesary information.
Development
After checking out the repo, run bin/setup
to install dependencies. Then, run rake test
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 the created tag, and push the .gem
file to rubygems.org.
Pending features
- Password protect database (Important!).
- Add a logger.
- Tests needs work.
- Update services.
- Export and Import data.
- Any good proposal?
Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
License
The gem is available as open source under the terms of the GPL-3.0 License.