bitwarden-md-generator/README.md

Bitwarden Markdown Generator

This Python script converts a Bitwarden JSON export file into a formatted Markdown file. It organizes password entries by folder and includes details such as creation date, modification date, username, password, and notes.

Features

• Converts Bitwarden JSON export to Markdown format.
• Organizes entries by folder.
• Includes detailed information for each entry.
• Easy to use and customize.

Requirements

• Python 3.x
• uv dependency manager

Installation

1. Clone the repository:

   git clone https://github.com/gurix/bitwarden-md-generator.git
   cd bitwarden-md-generator
   

2. Install the required dependencies using uv:

   uv sync
   

Usage

1. Export your Bitwarden vault as a JSON file.

2. Update the json_file_path and output_md_path variables in the main function of the script to point to your Bitwarden JSON file and the desired output Markdown file location.

3. Run the script:

   uv run app.py
   

4. Check the specified output directory for the generated Markdown file.

Customization

• You can modify the format_date function to change the date format in the output.
• Adjust the Markdown template in the generate method to include or exclude specific details.