{"id":25085075,"url":"https://github.com/erikjuhani/basalt","last_synced_at":"2026-03-10T23:27:41.690Z","repository":{"id":275275012,"uuid":"693752164","full_name":"erikjuhani/basalt","owner":"erikjuhani","description":"TUI Application to manage Obsidian notes directly from the terminal","archived":false,"fork":false,"pushed_at":"2025-03-23T13:08:41.000Z","size":6738,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-23T13:38:17.733Z","etag":null,"topics":["markdown","obsidian","ratatui","tui"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erikjuhani.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-19T16:32:40.000Z","updated_at":"2025-03-23T13:08:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"e4bf34de-c3d9-4941-9c32-0bbed9ad58e8","html_url":"https://github.com/erikjuhani/basalt","commit_stats":null,"previous_names":["erikjuhani/basalt"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikjuhani%2Fbasalt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikjuhani%2Fbasalt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikjuhani%2Fbasalt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikjuhani%2Fbasalt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erikjuhani","download_url":"https://codeload.github.com/erikjuhani/basalt/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246636909,"owners_count":20809514,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","obsidian","ratatui","tui"],"created_at":"2025-02-07T07:20:13.725Z","updated_at":"2026-03-10T23:27:41.676Z","avatar_url":"https://github.com/erikjuhani.png","language":"Rust","funding_links":[],"categories":["Rust","Table of Contents"],"sub_categories":[],"readme":"\u003cimg align=\"left\" width=\"125px\" src=\"https://raw.githubusercontent.com/erikjuhani/basalt/refs/heads/main/assets/basalt.png?raw=true\"\u003e\u003ch3\u003eBasalt\u0026nbsp;\u0026nbsp;\u003c/h3\u003e\n\u003cp\u003eTUI Application to manage Obsidian notes\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003c/p\u003e\n\n\u003chr\u003e\n\nTUI Application to manage Obsidian vaults and notes directly from the terminal ✨.\n\n![Demo](https://raw.githubusercontent.com/erikjuhani/basalt/refs/heads/main/assets/basalt_demo.gif)\n\nBasalt is a cross-platform TUI (Terminal User Interface) for managing Obsidian vaults and notes. It runs on Windows, macOS, and Linux. Basalt is not a replacement for Obsidian. Instead, it provides a minimalist terminal interface with a [WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG) experience.\n\n## Installation\n\n- Using [Cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html):\n  ```sh\n  cargo install basalt-tui\n  ```\n\n- Using [aqua](https://aquaproj.github.io/docs/install):\n  ```sh\n  aqua g -i erikjuhani/basalt\n  ```\n\nOr download a pre-compiled binary from the [latest release](https://github.com/erikjuhani/basalt/releases/latest), extract it, and move the `basalt` binary to a location in your `PATH`.\n\n## Configuration\n\nBasalt can be customized using a TOML configuration file. The file does not exist by default — create it manually when you want to override the defaults.\n\n**macOS and Linux:**\n\n- `$HOME/.basalt.toml`\n- `$XDG_CONFIG_HOME/basalt/config.toml`\n\n**Windows:**\n\n- `%USERPROFILE%\\.basalt.toml`\n- `%APPDATA%\\basalt\\config.toml`\n\nIf configuration files exist in multiple locations, only the first one found is used. The home directory configuration takes precedence.\n\n\u003e [!WARNING]\n\u003e\n\u003e This behavior may change in future versions to merge all found configurations instead.\n\nSee the [full configuration reference](docs/Configuration/Configuration.md) for key mappings, custom commands, and defaults.\n\n## Documentation\n\n- [Getting started](docs/Getting%20started/Installation.md)\n- [User interface](docs/User%20interface/User%20interface.md)\n- [Configuration](docs/Configuration/Configuration.md)\n- [Editing and Formatting](docs/Editing%20and%20Formatting.md)\n- [Files and Folders](docs/Files%20and%20Folders.md)\n- [Known Limitations](docs/Known%20Limitations.md)\n\n## Contributing\n\nContributions are welcome, primarily for bug fixes. Feature work is considered on a case-by-case basis — please open an issue first to discuss.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, code style, and contribution guidelines.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferikjuhani%2Fbasalt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferikjuhani%2Fbasalt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferikjuhani%2Fbasalt/lists"}