{"id":14064953,"url":"https://github.com/TheSethRose/Time-Capsule","last_synced_at":"2025-07-29T19:32:06.793Z","repository":{"id":226865488,"uuid":"769839045","full_name":"TheSethRose/Time-Capsule","owner":"TheSethRose","description":"Time Capsule continuously captures and stores digital activities to create a comprehensive memory system. It features real-time audio recording, speech-to-text with Fast-Whisper, plugin support, database storage via Chroma, and a web interface for management. Ideal for documenting life or building digital memories.","archived":false,"fork":false,"pushed_at":"2024-10-29T18:08:20.000Z","size":1529,"stargazers_count":64,"open_issues_count":0,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-28T21:45:02.740Z","etag":null,"topics":["ai","audio-capture","chroma","data-storage","digital-memory","flask","memory","plugins","python","whisper"],"latest_commit_sha":null,"homepage":"","language":"Python","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/TheSethRose.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":"2024-03-10T07:50:31.000Z","updated_at":"2024-11-20T02:47:40.000Z","dependencies_parsed_at":"2024-04-13T02:44:37.237Z","dependency_job_id":"98a07bb8-3d04-48c2-b8d3-51bfa9785d34","html_url":"https://github.com/TheSethRose/Time-Capsule","commit_stats":null,"previous_names":["thesethrose/time-capsule"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSethRose%2FTime-Capsule","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSethRose%2FTime-Capsule/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSethRose%2FTime-Capsule/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSethRose%2FTime-Capsule/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheSethRose","download_url":"https://codeload.github.com/TheSethRose/Time-Capsule/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228040911,"owners_count":17860212,"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":["ai","audio-capture","chroma","data-storage","digital-memory","flask","memory","plugins","python","whisper"],"created_at":"2024-08-13T07:04:11.907Z","updated_at":"2024-12-04T03:31:46.985Z","avatar_url":"https://github.com/TheSethRose.png","language":"Python","funding_links":["https://www.buymeacoffee.com/TheSethRose","https://img.buymeacoffee.com/button-api/?text=Buy"],"categories":["Python"],"sub_categories":[],"readme":"# Time Capsule\n\nTime Capsule is a powerful tool designed to continuously capture and store your digital activities, creating a comprehensive digital memory. It provides a core system for data management with a web interface for interaction and optional plugins for various data capture methods.\n\n## ✨ Current Features\n\n- 🎙️ Real-time microphone recording\n- 🗣️ Speech-to-text transcription using Fast-Whisper library\n- 💾 Database storage of transcribed text using Chroma vector database\n- 🔌 Plugin system for extensibility\n- ⚙️ Configurable settings via JSON configuration file\n- 🖥️ Web interface for managing plugins and starting the application\n- 📊 Transcription service for processing audio recordings\n- 🌐 Flask-based web server for handling HTTP requests and responses\n- 🔄 Real-time status updates including CPU, memory, and disk usage\n\n## 🚀 Future Features\n\nFor a detailed list of planned features, please see our [TODO list](TODO.md).\n\n## 🛠️ Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/TheSethRose/Time-Capsule.git\n   cd Time-Capsule\n   ```\n\n2. Create and activate a virtual environment:\n\n   ```bash\n   python -m venv .venv\n   source .venv/bin/activate  # On Windows, use `.venv\\Scripts\\activate`\n   ```\n\n3. Install the required dependencies:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Configure settings in `config.json` according to your preferences.\n\n## 🖥️ Usage\n\nStart the Time Capsule application:\n\n```bash\npython main.py\n```\n\nThe application will start and display the URL for accessing the web interface. Use this interface to manage plugins and control the Time Capsule.\n\nPress `Ctrl+C` in the terminal to initiate a graceful shutdown of the application.\n\n## 🧩 Plugin System\n\nTime Capsule uses a plugin system for extensibility. Plugins are located in the `plugins` directory. Each plugin should be in its own subdirectory and contain a main class that matches the plugin name.\n\nTo create a new plugin:\n\n1. Create a new directory in the `plugins` folder with your plugin name.\n2. Create a Python file with the same name as your plugin.\n3. Implement the main plugin class with `start()` and `stop()` methods.\n\nPlugins can be enabled or disabled through the web interface or by modifying the `config.json` file.\n\n## 🔧 Configuration\n\nThe `config.json` file contains various settings for the application, including:\n\n- Database path\n- Audio recording settings\n- Transcription settings\n- Plugin states\n- Web interface refresh interval\n\nModify this file to customize the behavior of Time Capsule.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📧 Contact\n\nFor any questions, suggestions, or feedback, please feel free to reach out to me on X at [@TheSethRose](https://www.x.com/TheSethRose)\n\n## ❤️ Support\n\n\u003ca href=\"https://www.buymeacoffee.com/TheSethRose\" target=\"_blank\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy me a coffee!\u0026emoji=\u0026slug=TheSethRose\u0026button_colour=000000\u0026font_colour=ffffff\u0026font_family=Cookie\u0026outline_colour=ffffff\u0026coffee_colour=FFDD00\" alt=\"Buy Me A Coffee!\"\u003e\u003c/a\u003e\n\n## ⚠️ Disclaimer\n\nEnsure compliance with all applicable laws and regulations when using this software, particularly regarding privacy and data protection. Time Capsule captures and stores personal data, so use it responsibly and with proper consent.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheSethRose%2FTime-Capsule","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTheSethRose%2FTime-Capsule","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheSethRose%2FTime-Capsule/lists"}