Flow.Launcher.Plugin.ExtendedTimestamp

[](https://github.com/mpmansell/Flow.Launcher.Plugin.ExtendedTimestamp/actions/workflows/release.yml) 

A time plugin for Flow Launcher that provides the following options:

• Date: 2026-02-07T00:00:00
• Timestamp: 1770448295
• Time: 08:11:35
• Date & Time: 2026-02-07 08:11:35
• Full timestamp: 2026-Feb-07_081135
• Append full timestamp: _2026-Feb-07_081135
• Random filename: Fo7E712gWe_2026-Feb-07_081135

Installation

Using Poetry (Recommended for Development)

This project uses Poetry for dependency management.

1. Install Poetry if you haven't already:

   pip install poetry

2. Install project dependencies:

   poetry install

3. Run the plugin:

   poetry run python main.py

Standard Installation (for Flow Launcher)

1. Clone or download this repository into your Flow Launcher plugins directory
2. Install dependencies:

   pip install -r requirements.txt

Important Note

Note

⚠️ if the messages.mo files do not exist in translations, then running :warning: all scripts will fail. This includes the very option to compile the .po files that can be found in commands.py.

If the messages.mo giles exist, then the compile option in commands.py can be used to recompile any changes in the .po files. However, again not that this compilation will fail if .mo are absent.

In the case that missing .mo files need to be replaced, use the following command:

pybabel compile -d plugin/translations

or

initialise-translations

to rebuild them, after which the command:

poetry run commands.py compile

or

extendedtimestamp compile

should work without error.

Development

Setting up the Development Environment

1. Install dependencies with Poetry:

   poetry install

2. Run tests:

   poetry run bash test.sh

3. Run the plugin locally:

   poetry run python main.py

Code Quality Tools

The development environment includes tools for maintaining code quality:

• black: Code formatting
• mypy: Static type checking
• isort: Import sorting
• pre-commit: Git hooks for code quality checks

To set up pre-commit hooks:

poetry run pre-commit install

Managing Dependencies

To add a new dependency:

poetry add package-name

To add a development dependency:

poetry add --group dev package-name

Environment Configuration

Create a .env file in the project root to configure plugin behavior:

local=en_US
date_split_symbol=-
time_split_symbol=:

See .env.example for all available options.