{"id":13595632,"url":"https://github.com/epilys/bibliothecula","last_synced_at":"2025-08-20T03:31:47.827Z","repository":{"id":99585818,"uuid":"266067745","full_name":"epilys/bibliothecula","owner":"epilys","description":"document organizer with tags and full-text-search, in a simple and clean sqlite3 schema","archived":false,"fork":false,"pushed_at":"2024-04-18T13:14:14.000Z","size":33916,"stargazers_count":165,"open_issues_count":1,"forks_count":5,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-12-09T19:53:46.671Z","etag":null,"topics":["documents","gtk","rust","tags"],"latest_commit_sha":null,"homepage":"https://epilys.github.io/bibliothecula/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/epilys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","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":"2020-05-22T09:10:33.000Z","updated_at":"2024-11-25T02:49:51.000Z","dependencies_parsed_at":"2024-08-01T16:54:11.062Z","dependency_job_id":null,"html_url":"https://github.com/epilys/bibliothecula","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epilys%2Fbibliothecula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epilys%2Fbibliothecula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epilys%2Fbibliothecula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epilys%2Fbibliothecula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/epilys","download_url":"https://codeload.github.com/epilys/bibliothecula/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230388131,"owners_count":18217755,"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":["documents","gtk","rust","tags"],"created_at":"2024-08-01T16:01:54.104Z","updated_at":"2024-12-19T06:10:01.825Z","avatar_url":"https://github.com/epilys.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# bibliothecula [![License]][gpl3]\u0026nbsp;[![No Maintenance Intended]][no-maintenance]\n\n[gpl3]: https://github.com/epilys/bibliothecula/blob/main/COPYING\n[License]: https://img.shields.io/github/license/epilys/bibliothecula?color=white\n[No Maintenance Intended]: https://img.shields.io/badge/No%20Maintenance%20Intended-%F0%9F%97%99-red\n[no-maintenance]: https://unmaintained.tech/\n\n\u003e *bibliothēcula* f (genitive *bibliothēculae*); first declension (Late Latin)\n\u003e\n\u003e - small library\n\u003e - small collection of books\n\u003e - **document database with tags and full-text-search, in a simple and clean [`sqlite3`](https://sqlite.org/index.html) schema**\n\nOrganise documents with tags and other metadata with the option of storing multiple files per document.\n\nSee the [database schema](docs/schema.sql) and the [documentation](docs/).\n\n## Uses\n\n- Organise journal articles for bibliographies\n- Organise e-books\n- Store plain text notes with automatic full-text search and back-reference indexing (i.e. a [Zettelkasten](https://en.wikipedia.org/wiki/Zettelkasten))\n\n## Tooling\n\nThis repository has three small tools for this schema:\n\n- a [virtual FUSE filesystem written in Rust](biblfs/).\n- an [HTTP GUI written in python3 using django](bumblebat/).\n- a [GTK3 UI in Rust](bibliothecula-gtk/) that was written early and isn't functional.\n- an interactive python shell, `bibl-shell.py`, with convenient types and methods for working with your database:\n\n  ```console\n  % ./bibl-shell.py --help\n  usage: bibl-shell.py [-h] [-i {ipython3,python3}] [--autocommit] [-v]\n                       [--no-startup]\n                       db_name\n\n  Python shell with convenient methods and objects for an sqlite3\n  database with the bibliothecula schema. Licensed GPL-3.0-or-later\n\n  positional arguments:\n    db_name               sqlite3 database to use.\n\n  optional arguments:\n    -h, --help            show this help message and exit\n    -i {ipython3,python3}, --interpreter {ipython3,python3}\n                          interpreter to use.\n    --autocommit          Autocommit on every statement. If false, you'd have to\n                          remember to commit on your own before you close the\n                          connection.\n    -v, --verbose         Show SQL etc actions taken.\n    --no-startup          When using plain Python, ignore the PYTHONSTARTUP\n                          environment variable and ~/.pythonrc.py script.\n  ```\n \n  ```console\n  % python3.7 bibl-shell.py bibliothecula.db\n  python3 3.7.3 (default, Jan 22 2021, 20:04:44) [GCC 8.3.0]\n                              bibliothecula shell 📇 📚 🏷️  🦇\n         (_    ,_,    _)\n         / `'--) (--'` \\      exported objects:\n        /  _,-'\\_/'-,_  \\      - conn : sqlite3.Connection\n       /.-'     \"     '-.\\     -   db : Database (see NAMESPACE dict\n          ______ ______                            for every  import)\n        _/      Y      \\_       \u003e\u003e\u003e help(db)\n       // ~~ ~~ | ~~ ~  \\\\      \u003e\u003e\u003e help(conn)\n      // ~ ~ ~~ | ~~~ ~~ \\\\     \u003e\u003e\u003e print(LONG_SHELL_BANNER)\n     //________.|.________\\\\    \u003e\u003e\u003e db.stats()\n    `----------`-'----------'\n\n  Connected to bibliothecula.db, last modified 2021-06-21 00:07\n  \u003e\u003e\u003e\n  ```\n\n\u003chr /\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"./logo_t.png\" alt=\"Logo\" width=\"200\"\u003e\n\u003c/p\u003e\n\u003chr /\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepilys%2Fbibliothecula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fepilys%2Fbibliothecula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepilys%2Fbibliothecula/lists"}