KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #codex #claude-code #cli #react #mcp #open-source #deepseek-harness #dsh-plugin #ai

friend-tracker

★ 55 Open GitHub ↗

Friend Tracker: An Obsidian plugin to effortlessly manage your personal connections. Keep track of important dates like birthdays, anniversaries, and milestones, while logging meaningful interactions with friends, family, and colleagues—all within your favorite note-taking app.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Friend Tracker for Obsidian

A plugin for Obsidian that helps you keep track of friends, family, and your interactions with them. Never forget a birthday or important detail about someone you care about.

## Inspiration

This plugin was inspired by [Scott Stockdale's article on maintaining meaningful friendships](https://web.archive.org/web/20250409205126/https://entrepreneurscanparty.com/posts/how-to-be-a-more-awesome-friend). The core idea is that maintaining strong relationships requires a system for:

-   Tracking important dates and milestones
-   Recording meaningful interactions
-   Remembering personal details
-   Making regular meaningful touchpoints

Friend Tracker helps implement these relationship-building practices in a simple, organized way within Obsidian.

![image](https://github.com/user-attachments/assets/0f8ef3de-6c18-4813-a87a-1a7d5d1a680f)

## Features

-   **Contact Management**: Easily create and manage contact profiles with essential information
-   **Birthday Tracking**: Keep track of birthdays and see upcoming celebrations
-   **Interaction Logging**: Record and date your interactions with people
-   **Custom Fields**: Add custom fields to track any information that matters to you
-   **Notes Section**: Keep detailed notes about family members, relationships, or any other important details
-   **Smart Organization**: Sort contacts by name, age, or upcoming birthdays

## Usage

### Creating Contacts

1. Click the "Add Contact" button to create a new contact
2. Fill in their basic information (name, birthday, email, phone)
3. Add any custom fields you want to track
4. Use the notes section for additional details

### Tracking Interactions

1. Open a contact's profile
2. Click "Add Interaction" to log a new interaction
3. Enter the date and details of the interaction
4. View interaction history in chronological order

### Managing Birthdays

-   The main view shows upcoming birthdays
-   Sort by "Days Until Birthday" to see who's celebrating soon
-   Birthdays are automatically calculated and displayed in a friendly format

### Custom Fields

-   Add custom fields to track specific information
-   Fields are saved in the contact's YAML frontmatter
-   Easily edit or update field values

## Installation

1. Open Obsidian Settings
2. Go to Community Plugins and disable Safe Mode
3. Click Browse and search for "Friend Tracker"
4. Install the plugin and enable it

## Storage

All contact information is stored in markdown files with YAML frontmatter, making it:

-   Portable
-   Future-proof
-   Easy to backup
-   Compatible with other markdown tools

## Support

If you encounter any issues or have feature requests, please visit the [GitHub repository](https://github.com/buzzguy/friend-tracker/issues).

## Author

Created by [Dan Au](https://dausign.com)

## License

MIT License - see LICENSE for details

friend-tracker

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README