Project

mytotp

0.0
No release in over a year
Totp cli tool for who loves the cli. I made it for myself, I don't like others.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 1.3
~> 1.5
~> 0.7.0
~> 6.2
~> 5.56
~> 1.4, >= 1.4.2
~> 2.5, >= 2.5.4
 Project Readme

Mytotp

Another TOTP cli app. Nice UI, simple to use and user-friendly.

mytotp-gif

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!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

The gem is available as open source under the terms of the GPL-3.0 License.