Skip to main content

What is this?

It is a simple command line interface for Teampass (https://teampass.net). teampass-cli provides an executable called tpcli

IMPORTANT: To use the teampass-cli, you need to modify the file api/functions.php on the server there Teampass was installed. The modified version of the file api/functions.php is located in the lib folder in this repository. This moodified version of functions.php is tested with Teampass 2.1.27.35 and 2.1.27.36

Current version of functions.php is synchronized with the upstream version in Teampass repository.

As for the changes in the functions.php that have been made:

API methods have been added to the function restGet():

  1. For CLI list sub-command:

  • /list/folders

  • /list/items

  1. Get item and folder by ID:

  • /get/item/{item_id}

  • /get/folder/{folder_id}

  1. Search item and folder by Title:

  • /find/items/{item_title}

  • /find/items/{folder_title}

Installation

on most UNIX-like systems, you’ll probably need to run the following `install` commands as root or by using sudo

pip

pip install teampass-cli

from source

pip install git+http://github.com/verdel/teampass-cli

or

git clone git://github.com/verdel/teampass-cli.git
cd teampass-cli
python setup.py install

as a result, the tpcli executable will be installed into a system bin directory

Usage

tpcli --help
Usage: -c [OPTIONS] COMMAND [ARGS]...
Options:
  --api-endpoint TEXT  Teampass API endpoint.
  --api-key TEXT       Teampass API key.
  --help               Show this message and exit.

Commands:
  add     add entry to Teampass
  delete  delete entry from Teampass
  edit    edit entry in Teampass
  list    show entry from Teampass
  search  search entry in Teampass


tpcli add --help
Usage: -c add [OPTIONS]

Add entry to Teampass.

Options:
  --item              add item
  --folder            add folder
  --title TEXT        title for new folder or label for new item  [required]
  --login TEXT        login value for new item
  --password TEXT     password value for new item
  --description TEXT  description value for new item
  --folder-id TEXT    parent folder id  [required]
  --list              format output as list
  --table             format output as table
  --help              Show this message and exit.


tpcli delete --help
Usage: -c delete [OPTIONS]

Delete entry from Teampass.

Options:
  --item     delete item
  --folder   delete folder with sub-folders and items
  --id TEXT  entry id  [required]
  --help     Show this message and exit.


tpcli edit --help
Usage: -c edit [OPTIONS]

Edit entry in Teampass.

Options:
  --item              add item
  --folder            add folder
  --id TEXT           entry id  [required]
  --title TEXT        title for entry
  --login TEXT        login value for entry
  --password TEXT     password value for entry
  --description TEXT  description value for entry
  --folder-id TEXT    parent folder id
  --list              format output as list
  --table             format output as table
  --help              Show this message and exit.


tpcli list --help
Usage: -c list [OPTIONS]

List entry from Teampass.

Options:
  --item    show items
  --folder  show folders
  --list    format output as list
  --table   format output as table
  --tree    format output as tree
  --help    Show this message and exit.


tpcli search --help
Usage: -c search [OPTIONS] TEXT

Search entry in Teampass.

Options:
  --item    search items
  --folder  search folders
  --list    format output as list
  --table   format output as table
  --help    Show this message and exit.

Release files for teampass-cli 0.0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for teampass-cli 0.0.13
File Size Uploaded
teampass-cli-0.0.13.tar.gz 7.1 kB Details

Release files / teampass-cli-0.0.13.tar.gz

Download URL teampass-cli-0.0.13.tar.gz
Size 7.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c8f1c217e0edda7a81a547a2fc98ed4c4ceaaa201a507936d70ec967304c16e5
BLAKE2b-256 checksum
How to use checksums
0e08b8d97a470dd81fb78aa26f442ba63fe0fd3b6e56d6abe8a9a45194777e3d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.5

Release history Release notifications | RSS feed

This release

0.0.13 This release

1 release file

0.0.10

1 release file

0.0.9

1 release file

0.0.8

1 release file

0.0.7

1 release file

0.0.6

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page