A Mooltipass Python library and command line management utilities.
Download this latest repository from Github.
$ wget https://github.com/oSquat/mooltipy/archive/refs/heads/master.zip
$ unzip ./master.zip
$ sudo python3 ./mooltipy-master/setup.py install
Set, get, list and delete login contexts (login credentials) with mooltipy.
Below is an example of how to add new login contexts.
# Add or update user_name at example.com with a randomly generated password.
$ mooltipy login set example.com -u user_name
# ... some sites only allow alphanumeric passwords; avoid symbols in a generated password.
$ mooltipy login set example.com -u user_name -c alnum
# ... ask for the password rather than generating one.
$ mooltipy login set example.com -u user_name -p
Get passwords from the Mooltipass. This could be used in a script, for example.
$ mysql --user root --password=$(mplogin get mysql)
Delete a login or entire context.
# Delete example_user from example.com
$ mooltipy login del example.com -u example_user
# Erase example.com entirely.
$ mooltipy login del example.com
List contexts stored in the Mooltipass.
$ mooltipy login list
Context: Login(s):
-------- ---------
Example.com user_name
Example.net user_name
# Unix shell-style globbing supported
$ mooltipy list *.net
Context: Login(s):
-------- ---------
Example.net user_name
The Mooltipass can be used to securely store small data files! Think ssh or gpg keys and cryptocurrency wallets.
$ mooltipy data set ssh_key ~/.ssh/id_rsa
$ mooltipy data get ssh_key ./restored_key
$ mooltipy data del ssh_key
It supports reading from / writing to stdin / stdout for convenience, but this can also be used as a workaround to store values greater than 31 characters.
$ echo "this-is-a-secure-api-key" | mpdata set example-api-key
$ echo $(mpdata get example-api-key)
this-is-a-secure-api-key
Warning: Do not disconnect your mooltipass during data transfer! Ctrl-C can be used to gracefully cancel a transfer.
Use the favorites utility to get, set and remove entries in favorite slots.
$ mooltipy favorites list
$ mooltipy favorites set
$ mooltipy favorites del
There are some parameters which can be set on the Mooltipass such as the keyboard layout or enabling offline mode.
$ mooltipy parameters set offline_mode 1
$ mooltipy parameters list
Parameter : init : current
--------------------------------------
after_login : 0x2b : 0x2b
after_login_enable : 1 : True
after_pass : 0x28 : 0x28
after_pass_enable : 1 : True
flash_screen : 1 : True
hash_display_enable : 1 : True
invert_screen : 0 : False
key_delay : 5 : 5
key_delay_enable : 1 : False
keyboard_layout : 0x92 : 0x92
knock_enable : 1 : True
knock_threshold : 8 : 8
led_anim_mask : 0xff : 0xff
lock_enable : 1 : True
lock_timeout : 60 : 60
lock_timeout_enable : 0 : False
lut_boot : 1 : True
offline_mode : 0 : False
oled_contrast : 0x80 : 0x80
random_init_pin : 0 : False
screen_saver_speed : 15 : 15
screensaver : 0 : False
touch_charge_time : 0 : 0
touch_di : 6 : 6
touch_prox_os : 0x73 : 0x73
touch_wheel os_0 : 0x21 : 0x21
touch_wheel os_1 : 0x21 : 0x21
touch_wheel os_2 : 0x21 : 0x21
tutorial : 1 : False
user_intr_timer : 15 : 15
The mooltipy command is a wrapper for individual utilities. To get help for any of the individual utilities you can:
$ mooltipy data --help
$ mooltipy login --help
$ mooltipy favorites --help
$ mooltipy parameters --help
You can also call any of the utilities directly by prefixing mp to the name of the utility:
$ mpdata --help
$ mplogin --help
$ mpfavorites --help
$ mpparams --help
To utilize the MooltipassClient class:
from mooltipy import MooltipassClient
import sys
mooltipass = MooltipassClient()
if mooltipass is None:
print('Could not connect to the Mooltipass')
sys.exit(0)
mootipass.do_some_stuff()Check out the MooltipassClient and Mooltipass classes to see what's implemented and see each utility as excellent examples of how to interact with the device.