This is THE major update everyone has been waiting for! After months of development (and extensive help from our AI friends!), Obsidian Python Bridge transitions from a promising concept to a robust, cross-platform, and incredibly feature-rich tool for bringing your Python scripts into Obsidian.
π What's New in V2.0.0? The "Huge Gap" Explained!
Remember V1? It was a start, a proof-of-concept primarily for Linux users. V2 is a complete overhaul, designed for stability, ease of use, and massively expanded capabilities.
Here's a glimpse of the massive upgrade:
- π CROSS-PLATFORM AT LAST! (HTTP Communication): The biggest hurdle is overcome! Thanks to a switch from Unix sockets to a secure local HTTP server, the bridge now works seamlessly on Windows, macOS, and Linux. No more platform limitations!
- βοΈ SCRIPT-SPECIFIC SETTINGS UI: This is a game-changer! Your Python scripts can now define their own settings (API keys, toggles, numbers, dropdowns...) which automatically appear in the Obsidian plugin settings tab. Users can configure your scripts directly β making them feel like native plugins!
- π FULL VAULT API ACCESS: Go way beyond the active note!
- List all note paths (relative or absolute).
- Full File & Folder Management: Create, check existence, rename, delete notes and folders.
- Get Links & Backlinks: Retrieve outgoing links and incoming backlinks (with optional integration with the Backlink Cache plugin for speed!).
- Read/Modify any note's content or frontmatter by path.
- π EVENT LISTENING: Make your scripts reactive! Register listeners for Obsidian events like
vault-modify
,vault-delete
,vault-rename
,metadata-changed
, and more. Trigger actions automatically based on what happens in your vault. - π ENHANCED SCRIPT MANAGEMENT:
- Activation Control: Enable or disable individual scripts directly in settings.
- Auto-Start: Configure scripts to run automatically when Obsidian starts (with optional delay).
- Dynamic Commands: Assign keyboard shortcuts to your favorite scripts easily.
- π MASSIVE INTERNATIONALIZATION (i18n): The plugin interface now speaks over 30 languages, making it accessible globally.
- π‘οΈ ROBUSTNESS & USABILITY:
- Automatic Python detection (tries
py
,python3
,python
). - Startup checks for Python & required
requests
library. - Automatic PYTHONPATH setup (configurable) for easy library imports.
- Improved error handling and logging.
- Secure communication via
127.0.0.1
.
- Automatic Python detection (tries
- β¨ API IMPROVEMENTS:
get_active_note_content
can now return content as a single string OR a list of lines.- Added
get_editor_context
,get_vault_name
,get_theme_mode
,get_obsidian_language
, and many more file operations.
- π BUG FIXES & STABILITY: Addressed issues like preventing unintended script execution during settings discovery.
Spot the difference? V2 brings the power:
πΎ Whatβs Included in the Release Files
The attached ZIP file (e.g., obsidian-python-bridge-2.0.0.zip
) contains everything needed to manually install the plugin. Simply extract all its contents directly into your Obsidian vault's plugin folder: .obsidian/plugins/obsidian-python-bridge/
.
(The Python library ObsidianPluginDevPythonToJS.py
is now typically handled via the "Auto-set PYTHONPATH" setting within the plugin, but is also available in the main repository if needed).
π οΈ How to Install
Please refer to the updated Installation Section in the README for the latest instructions.
βοΈ Configuration & Usage
After installation, please check the Configuration and Using the Python Library sections in the README.
Don't forget to consult the detailed Python Client Library Documentation for all available functions and examples, especially the recommended script structure for handling settings discovery!
π A Word on Support & Development
This V2 represents a huge leap, involving countless hours and significant personal investment (including AI assistance costs). If you find this plugin saves you time and enables new workflows, please consider supporting the project (details in the main README).
Whatβs Next?
With this robust foundation, future development can focus on adding even more API endpoints, refining existing features, and hopefully, seeing amazing scripts developed by the community!
Thank you for your patience and support! Enjoy V2!