GitHub Stars Manager

简体中文 README | Usage Guide | 使用指南

A powerful Obsidian plugin that allows you to manage and view your GitHub starred repositories directly within Obsidian, with multi-account support, custom tags, smart search, and beautiful themes.

✨ Core Features

📊 Repository Management

• 📋 View all your starred GitHub repositories within Obsidian
• 👥 Multi-account support: Manage stars from multiple GitHub accounts simultaneously
• ⭐ Star statistics: Real-time display of total repository count and stars
• 🔄 Smart sync: Automatic or manual synchronization of starred repositories
• 🔄 Account management: Enable/disable sync for specific accounts individually

🏷️ Personalization

• 🏷️ Tag Chips Component: Intuitive tag chip input with quick selection of existing tags
• 📝 Add custom tags and notes to repositories
• 🔗 Link repositories to Obsidian note files
• 💾 All annotation data stored locally for privacy protection

🔍 Smart Search & Filter

• 🔎 Real-time search by name, description, language, tags
• 🎯 Support for regular expressions and fuzzy matching
• 📊 Multi-dimensional sorting: by star time, name, language, star count, etc.
• 🏷️ Advanced filtering based on tags

🎨 Beautiful Themes

• 🎨 Default Theme: Clean card layout that integrates seamlessly with Obsidian's native theme
• 🌊 Liquid Glass Theme: iOS-style frosted glass effect with dynamic backgrounds and shimmer animations
• 📱 Responsive waterfall layout: Pinterest-style card display
• ✨ Smooth animations and hover effects

🔒 Security & Privacy

• 🔐 Secure authentication using GitHub Personal Access Token
• 💾 All data stored locally, no upload to any third-party servers
• 🛡️ Compliant with Obsidian plugin store security standards
• ✅ Passed all eslint-plugin-obsidianmd rule validations

Configuration

To use this plugin, you need to provide a GitHub Personal Access Token (PAT) with the necessary permissions to read your starred repositories.

How to get a GitHub Personal Access Token (PAT):

1. Login to GitHub: Visit github.com and log in to your account.
2. Access Settings: Click your profile picture in the top-right corner, then select "Settings".
3. Developer Settings: In the left sidebar, scroll down and click "Developer settings".
4. Personal Access Tokens: In the left sidebar, select "Personal access tokens", then choose "Tokens (classic)". (Note: Please select Classic Token, as Fine-grained tokens might require more complex permission setup).
5. Generate New Token: Click the "Generate new token" button, then select "Generate new token (classic)".
6. Token Description: In the "Note" field, give your token a descriptive name, e.g., "Obsidian Stars Manager".
7. Set Expiration: Choose an appropriate expiration duration. For security, "No expiration" is not recommended.
8. Select Scopes: This is crucial. You need to grant permission to access your repositories. Check the top-level repo scope checkbox. This automatically selects all necessary sub-permissions for the plugin to read your starred repositories.
9. Generate Token: Click the "Generate token" button at the bottom of the page.
10. Copy Token: Important! GitHub will only show the full token once. Click the copy icon immediately to copy it and store it securely. You won't be able to see the full token again after leaving this page.
11. Use in Plugin: Paste the copied token into the "GitHub Personal Access Token (PAT)" field in the "GitHub Stars Manager" settings tab within Obsidian.

Usage

1. After installing and enabling the plugin, a GitHub star icon will appear in the left panel
2. Click the icon to open the starred repositories view
3. Configure your GitHub PAT in the plugin settings on first use
4. Click the "Sync" button to fetch your starred repositories
5. You can add personal notes, tags, or link repositories to existing Obsidian notes

📖 View Detailed Usage Guide | 中文指南

Theme Switching

The plugin provides two visual themes:

• Default Theme: Clean card layout that maintains consistency with Obsidian's native themes
• iOS Glass Theme: iOS-style frosted glass effect with the following features:
  • 🌈 Colorful gradient backgrounds for better visual contrast
  • ✨ Dynamic floating animation background effects
  • 🔍 Enhanced frosted glass blur effects
  • 💫 Shimmer sweep animation on card hover
  • 📱 Waterfall layout similar to Xiaohongshu's card display
  • 🎯 Optimized font rendering to avoid blur issues on hover

You can quickly switch themes using the theme button at the top of the plugin interface.

Installation

From Obsidian Community Plugins (Recommended)

1. Open Obsidian Settings
2. Go to "Community plugins" tab
3. Search for "GitHub Stars Manager"
4. Click Install and enable the plugin

Manual Installation

1. Download the latest main.js, manifest.json, and styles.css
2. Copy these files to your vault: VaultFolder/.obsidian/plugins/obsidian-github-stars-manager/
3. Restart Obsidian
4. Enable the plugin in settings

Development

Requirements

• Node.js 16+
• npm or yarn

Development Commands

# Install dependencies
npm install

# Development mode (watch for changes)
npm run dev

# Production build
npm run build

# Version bump
npm run version

Tech Stack

• TypeScript: Type-safe JavaScript superset
• Obsidian API: Plugin development framework
• GitHub REST API: Access GitHub data via @octokit/rest
• CSS3: Modern styling and animation effects
• esbuild: Fast JavaScript bundler

Project Structure

├── src/
│   ├── main.ts          # Main plugin class
│   ├── view.ts          # Starred repositories view
│   ├── settings.ts      # Plugin settings
│   ├── modal.ts         # Edit modal dialogs
│   ├── githubService.ts # GitHub API service
│   └── types.ts         # TypeScript type definitions
├── main.ts              # Plugin entry point
├── manifest.json        # Plugin manifest
├── styles.css          # Stylesheet
└── README.md           # Documentation

Changelog

v0.1.1 (Current Version)

• 🏷️ Added Tag Chips input component with quick tag selection
• ⭐ Added total stars count display feature
• 🎨 Enhanced note card visibility and UI styling
• 🔧 Enabled all 25 eslint-plugin-obsidianmd rules
• 🐛 Fixed token error handling and error messages
• 🛡️ Passed Obsidian plugin store security review
• 🤖 Configured pre-commit hooks and GitHub Actions CI/CD

v0.1.0

• ✨ Initial release
• 🎯 Multi-account GitHub Stars management
• 🎨 Liquid Glass theme support
• 📱 Responsive waterfall layout
• 🔍 Advanced search and filtering
• 🏷️ Custom tags and notes functionality

License

MIT License - see LICENSE file for details

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Support

If you find this plugin helpful, consider:

• ⭐ Starring the project
• 🐛 Reporting bugs or suggesting improvements
• 💡 Sharing it with other Obsidian users
• 💖 Sponsor the developer

Related Links

• Obsidian Official Website
• GitHub API Documentation
• Plugin Development Documentation