Obsidian Duplicate Finder

Introduction and Purpose

The Obsidian Duplicate Finder is a user-friendly tool designed to help users manage duplicate files within their Obsidian vaults. It identifies similar Markdown files based on their content, making it easier to organize and declutter note-taking environments. This program is particularly useful for anyone working with large amounts of Markdown content and looking to streamline their workflow by removing redundant files.

Key Features:

• Detects duplicate or highly similar Markdown files in Obsidian vaults.
• Offers a customizable similarity threshold for fine-tuned results.
• Provides an intuitive graphical interface for previewing and managing duplicate files.

Getting Started

Follow these steps to download, set up, and run the program:

Step 1: Download the Program

1. Click on the green Code button on the repository's GitHub page.
2. Select Download ZIP and save the file to your computer.
3. Extract the downloaded ZIP file to a folder on your system.

Step 2: Install Python and Dependencies

1. Make sure Python 3.7 or later is installed on your computer. If not, download it from python.org and install it.
2. Install the required dependencies by running the following command in your terminal or command prompt:

   pip install -r requirements.txt
   

Step 3: Run the Program

1. Navigate to the folder where you extracted the ZIP file.
2. Double-click the obsidian-deduper.py file to start the program. Alternatively, run the following command in your terminal or command prompt:

   python obsidian-deduper.py
   

3. The graphical interface will open, allowing you to select your Obsidian vault folder and start finding duplicates.

Use Cases and Examples

Example 1: Streamlining an Academic Vault

A student managing hundreds of notes in an Obsidian vault can use the Obsidian Duplicate Finder to:

• Identify redundant lecture notes or research articles.
• Adjust the similarity threshold to locate files with slight variations, such as different citations or formatting styles.
• Preview content before deletion to ensure important information is retained.

Example 2: Organizing a Personal Knowledge Base

A professional maintaining a personal knowledge management system can:

• Quickly identify duplicate ideas or repeated journal entries.
• Use the program’s delete feature to clean up the vault, freeing up storage space and improving navigation.

Example 3: Collaborative Vault Management

Team members sharing a collaborative vault can use the tool to:

• Detect and remove duplicate meeting notes or project documents.
• Optimize the vault for smoother collaboration and reduced clutter.

Disclaimers and Updates

• This program may be updated periodically to enhance functionality or address issues. Updates might include changes to the code, features, or interface.
• The README file might not always reflect the latest updates to the repository. Users are encouraged to review the code or contact the maintainer for clarifications if needed.

---

Enjoy a more organized Obsidian vault with the Obsidian Duplicate Finder!