# The Spirit's Book

An Obsidian plugin to study and explore *The Spirit's Book* by Allan Kardec, directly within your vault.

## ✨ Features

- 🔍 **Search** questions and answers by number or keyword  
- 🔀 **Get a random question** for daily reflection or inspiration  
- ⭐ **Mark favorites** for quick access later  
- 🌐 **Multilingual support**: English, Portuguese, Spanish, and French (WIP)  
- 📚 **Structured content** with book, parts, chapters, and questions  

## ⚠️ Mobile Incompatibility

> **Important:** This plugin is **not compatible with Obsidian Mobile** (iOS or Android).  
> It was designed for **desktop use only**, due to technical limitations of the mobile API and filesystem access.

## 📦 Installation

### Community Plugins (recommended)

1. In Obsidian, go to **Settings > Community Plugins > Browse**
2. Search for **"The Spirit's Book"**
3. Click **Install**, then **Enable**

### Manual installation

1. Download or clone this repository
2. Copy the `spirits-book` folder to your `.obsidian/plugins/` directory
3. Copy `data` folder to your `.obsidian/plugins/spirits-book` directory
4. Restart Obsidian and enable the plugin

## 🌍 Supported Languages

- 🇧🇷 Portuguese (original)
- 🇬🇧 English
- 🇪🇸 Spanish
- 🇫🇷 French

## 🧠 About The Spirit's Book

> “The Spirit's Book” (1857) is the foundational work of Spiritism, authored by Allan Kardec. It contains 1,019 questions and answers about life, God, the soul, reincarnation, and the spirit world.

This plugin helps you study its content with modern tools and flexible navigation.

## 🔧 Configuration

You can:
- Change the display language
- View a random question
- Favorite or unfavorite any item
- Search by number, topic, or word

## 📘 Example Use Cases

- Spiritual daily study
- Note-linking with commentary in your Obsidian vault
- Group study or Kardecist course integration

## 💡 Future Plans

- [ ] Export to Markdown
- [ ] Contextual linking to your notes
- [ ] Timeline study tracking
- [ ] Add search functionality
- [ ] Improve UI customization
- [ ] Add more languages (e.g., German, Italian)
- [ ] Implement daily question notifications

## ☕ Support this project

If this plugin is useful for your spiritual studies, you can support my work:

<a href="https://www.buymeacoffee.com/ahlrodrigues" target="_blank">
  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee" height="40">
</a>

Or, if you're in Brazil, use Pix:  
Chave: `ahlr_2000@yahoo.com`  
Nome: Antonio Henrique

Thank you! 🙏

### 🛠️ Developed by

[Antonio Henrique](c)

Contributions welcome!

---

### ✍️ About the Author

    "Those who look outside dream; those who look inside awaken." — Carl Jung

Enthusiast of great ideas  
Spiritist 👻 · Vegetarian 🥬 · Psychoanalyst 🧠 · People Manager 🤝  
#Linux · #OpenSource · #Slackware · #Coffee ☕ · #KDE · #HamRadio 🛰️ · #Obsidian

GitHub: @ahlrodrigues

---

#spirits-book #the-spirits-book #allan-kardec #spiritism #spirituality #mediumship #kardecism #philosophy #moral-education #personal-growth #religion #esoteric #study-tool