49 lines
1.3 KiB
Markdown
49 lines
1.3 KiB
Markdown
|
# 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:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
git clone https://github.com/gurix/bitwarden-md-generator.git
|
||
|
|
cd bitwarden-md-generator
|
||
|
|
```
|
||
|
|
|
||
|
|
2. Install the required dependencies using `uv`:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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.
|