tsigna 0.3.0

Terminal tool to plot stocks, crypto, pair ratios, and technical indicators like MACD and RSI.

Tsigna

Tsigna is a Python financial analysis tool that runs entirely in the terminal. It is most useful for medium-term trading. It fetches historical stock data from Yahoo Finance, calculates technical indicators including moving averages, MACD, and RSI, and displays them as text-based charts using the plotille library. The tool supports single ticker analysis, ratio comparisons between two tickers, and a special MMRI calculation. Users can customize the time period and split the terminal display to show multiple indicators simultaneously.

Background

Originally I was looking for a free online tool to plot the ratio between two tickers, but I didn't find such a tool so I started working on Tsigna. The name comes from 'T' for terminal and the plural form of signum, the latin word for signal. The 'T' also stands for technical, like in technical indicators, from which we get technical signals.

Dependencies

Tsigna requires the following external libraries:

• pandas: Used for data manipulation and analysis.
• plotille: Used for creating terminal-based plots.
• yahooquery: Used for fetching financial data from Yahoo Finance.

These libraries and their sub-dependencies will be installed automatically when you install Tsigna.

Installation

It is recommended to install Tsigna within a virtual environment to avoid conflicts with system packages. Some Linux distributions enforce this. You can use pipx to handle the virtual environment automatically, or create one manually and use pip.

Installation with pipx

pipx installs Tsigna in an isolated environment and makes it available globally.

1. Install pipx:

• Linux (Debian / Ubuntu / Mint):

  sudo apt install pipx
  pipx ensurepath
  

• Linux (Other) / macOS:

  python3 -m pip install --user pipx
  python3 -m pipx ensurepath
  

• Windows:

  python -m pip install --user pipx
  python -m pipx ensurepath
  

You may need to reopen your terminal for the PATH changes to take effect. If you encounter a problem, please refer to the official pipx documentation.

2. Install Tsigna:

pipx install tsigna

Installation with pip

If you prefer to manage the virtual environment manually, you can create and activate it by following this tutorial. Then install Tsigna:

pip install tsigna

Deployments

View all releases on:

• PyPI Releases
• GitHub Releases

Usage

Basic Usage

tsigna [arguments] [TICKER1] [TICKER2]

Arguments

Argument	Short Flag	Description
--help	-h	Show help message
--atr	-a	Display ATR indicator (Average True Range)
--atr-only	-A	Display only ATR indicator
--bollinger	-b	Display Bollinger Bands indicator
--mfi	-f	Display MFI indicator (Money Flow Index)
--mfi-only	-F	Display only MFI indicator
--indicator-info	-i	Show indicator information
--log-scale	-l	Use a logarithmic scale on the y-axis
--macd	-m	Display MACD indicator (Moving Average Convergence Divergence)
--macd-only	-M	Display only MACD indicator
--no-cache	-n	Bypass cache and get latest data
--obv	-o	Display OBV indicator (On-Balance Volume)
--obv-only	-O	Display only OBV indicator
--rsi	-r	Display RSI indicator (Relative Strength Index)
--rsi-only	-R	Display only RSI indicator
--stoch	-s	Display Stochastics indicator
--stoch-only	-S	Display only Stochastics indicator
--version	-v	Show program's version number and exit
--volume	-w	Display volume
--volume-only	-W	Display only volume
--years	-y	Set years to plot, use 0 for ytd (default: 1)

Configuration

When you run Tsigna for the first time, a config.toml file is automatically created. Its location depends on your operating system (typical paths are listed below):

• Linux: ~/.config/tsigna
• macOS: ~/Library/Preferences/tsigna
• Windows: C:/Users/YourUsername/AppData/Roaming/tsigna

You can edit this file to customize various settings. Common customizations include changing the expiration time of the cache (or disabling it), modifying the line colors, or changing the parameters of the technical indicators.

Not Financial Advice

I do not own any of the stocks in the examples, I chose them because they are very popular.

License

Copyright (c) 2025 Monsieur Linux

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgements

Tsigna is not doing much more than getting data from yahooquery, processing it with pandas, and plotting it with plotille, so thanks to the creators and contributors of these powerful libraries for making it possible.

Thanks also to the ticker tool, which is very useful to track prices in real time from the terminal.