# Standalone tool and library
[](https://pypi.org/project/intellireading-cli)
[](https://pypi.org/project/intellireading-cli)
[](https://github.com/0x6f677548/intellireading-backend/actions/workflows/build-and-publish-to-ghcr.yml)
[](https://github.com/0x6f677548/intellireading-cli/actions/workflows/lint.yml)
[](https://github.com/0x6f677548/intellireading-cli/actions/workflows/test.yml)
Intellireading is a CLI tool with commands to accelerate your reading experience. It can also be used as a python library.
Currently, it supports metaguiding an EPUB, KEPUB, XHTML, or HTML file (more features coming):
```console
> intellireading metaguide-epub --input_file mybook.epub --output_file mybook_metaguided.epub
```
Example of a text converted to a metaguided text:
This repo is part of the [Intellireading](https://intellireading.com/) project, which aims to help people with dyslexia, ADHD, or anyone who wants to improve their reading focus and speed.
## [Other Intellireading Code Repositories](https://github.com/stars/0x6f677548/lists/intellireading)
- [Intellireading website](https://www.github.com/0x6f677548/intellireading-www), which allows anyone to convert an Epub to the metaguided version.
- [Backend Servers](https://www.github.com/0x6f677548/intellireading-backend), that support the Intellireading website.
- [CLI Tool](https://www.github.com/0x6f677548/intellireading-cli). A standalone tool and library that can be used to metaguide epub files.
- [Calibre Plugins](https://www.github.com/0x6f677548/intellireading-calibre-plugins). A set of plugins that can be used to metaguide epub files using Calibre.
## What is Epub Metaguiding?
**Metagu**iding **i**s **a** **techn**ique **th**at **ca**n **b**e **us**ed **t**o **impr**ove **yo**ur **read**ing **foc**us **an**d **spe**ed **(some**times **cal**led **Bio**nic **Readi**ng). **I**t **i**s **bas**ed **o**n **th**e **id**ea **th**at **yo**u **ca**n **us**e **a** **vis**ual **gui**de **t**o **he**lp **yo**ur **ey**es **foc**us **o**n **th**e **te**xt **yo**u **ar**e **read**ing. **I**n **th**is **cas**e, **th**e **vis**ual **gui**de **i**s **do**ne **b**y **bold**ing **a** **pa**rt **o**f **th**e **tex**t, **crea**ting **vis**ual **anch**ors **th**at **yo**ur **ey**es **ca**n **us**e **t**o **foc**us **o**n **th**e **tex**t. **Th**is **i**s **simi**lar **t**o **th**e **wa**y **a** **fin**ger **ca**n **b**e **us**ed **t**o **gui**de **yo**ur **ey**es **alo**ng **a** **li**ne **o**f **tex**t, **whi**ch **ha**s **be**en **sho**wn **t**o **impr**ove **read**ing **spe**ed **an**d **foc**us. ([**stu**dy: **"Do**es **finger-t**racking **poi**nt **t**o **chi**ld **read**ing **strate**gies"](https://ceur-ws.org/Vol-2769/paper_60.pdf))
**Howe**ver, **unl**ike **a** **fing**er, **th**e **vis**ual **gui**de **i**s **no**t **distra**cting, **an**d **i**t **ca**n **b**e **us**ed **t**o **gui**de **yo**ur **ey**es **alo**ng **mult**iple **lin**es **o**f **te**xt **a**t **onc**e. **Th**is **all**ows **yo**u **t**o **re**ad **fast**er, **an**d **wi**th **le**ss **effo**rt.
**Metagu**iding **i**s **partic**ulary **use**ful **fo**r **peo**ple **wi**th **dysl**exia **o**r **ADH**D, **bu**t **i**t **ca**n **b**e **us**ed **b**y **any**one **wh**o **wan**ts **t**o **impr**ove **the**ir **read**ing **foc**us **an**d **spe**ed. **Fo**r **mo**re **inform**ation, **vis**it **th**e [**Intelli**reading **webs**ite.](https://intellireading.com/)
## Features
Intellireading commands can be used to:
- **Metaguide an EPUB file**: Metaguide an EPUB file, transforming it into a metaguided EPUB file, by transforming all XHTML files in the EPUB file into metaguided XHTML files.
- **Metaguide an XHTML file**: Metaguide an XHTML file, transforming it into a metaguided XHTML file.
- **Metaguide a directory**: Metaguide all files in a directory, transforming all EPUB, XHTML, and HTML files into metaguided files.
## Installation
Intellireading is a command line tool that can be used in Windows, Linux, and MacOS. It is written in Python and can be used as a module or as a standalone tool, as long as you have Python >3.7 installed (or Docker).
### pip
To install it, you can use pip:
```console
> pip install intellireading-cli
> intellireading --help
```
### From source code
You can also install it from the source code:
```console
> git clone https://github.com/0x6f677548/intellireading-cli.git
> cd intellireading-cli
> pip install .
> intellireading --help
```
### Docker
Alternatively, you can use the Docker image:
#### Help command
```console
> docker pull ghcr.io/0x6f677548/intellireading-cli:latest
> docker run -it --rm ghcr.io/0x6f677548/intellireading-cli --help
```
#### Metaguide an EPUB file
##### Linux/MacOS
```console
```linux
> docker run -it --rm -v $(pwd)/tests:/tests ghcr.io/0x6f677548/intellireading-cli metaguide-epub --input_file '/tests/test_files/input.epub' --output_file '/tests/test_files/output.epub'
```
##### Windows
```powershell
> docker run -it --rm -v ${pwd}/tests:/tests ghcr.io/0x6f677548/intellireading-cli metaguide-epub --input_file '/tests/test_files/input.epub' --output_file '/tests/test_files/output.epub'
```
## Usage
All available commands and options can be seen by using the `--help` option.
```console
> intellireading --help
```
To get help on a specific command, use the `--help` option with the command name. For example, to get help on the `metaguide-epub` command, use the following command:
```console
> intellireading metaguide-epub --help
```
Intellireading is based on [Click](https://github.com/pallets/click/), taking advantage of its features, such as chaining commands and options.
### Usage Examples
#### Metaguide an EPUB file
To metaguide an EPUB file, use the `metaguide-epub` command. The command requires the path to the EPUB file and the output file. The output file will be a metaguided epub file.
```console
> intellireading metaguide-epub --input_file mybook.epub --output_file mybook_metaguided.epub
```
#### Metaguide a XHTML file
To metaguide an XHTML file, use the `metaguide-xhtml` command. The command requires the path to the XHTML file and the output file. The output file will be a metaguided xhtml file.
```console
> intellireading metaguide-xhtml --input_file mybook.xhtml --output_file mybook_metaguided.xhtml
```
#### Metaguide all files in a directory
To metaguide all files in a directory, use the `metaguide-dir` command. The command requires the path to the directory and the output directory. The output directory will contain all metaguided files, including epub, xhtml and html files.
```console
> intellireading metaguide-dir --input_dir mydir --output_dir mydir_metaguided
```
Raw data
{
"_id": null,
"home_page": null,
"name": "intellireading-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "adhd, calibre, dyslexia, ebook, epub, kepub, kindle, kobo, speed-reading",
"author": "0x6f677546 (Hugo Batista)",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/aa/86/ad9b40c457326838bcebf56f6a1837894ecbcf8c9dabff13f3b73de07a4c/intellireading_cli-2.0.0.tar.gz",
"platform": null,
"description": "\n# Standalone tool and library\n\n[](https://pypi.org/project/intellireading-cli)\n[](https://pypi.org/project/intellireading-cli)\n[](https://github.com/0x6f677548/intellireading-backend/actions/workflows/build-and-publish-to-ghcr.yml)\n[](https://github.com/0x6f677548/intellireading-cli/actions/workflows/lint.yml)\n[](https://github.com/0x6f677548/intellireading-cli/actions/workflows/test.yml)\n\n\nIntellireading is a CLI tool with commands to accelerate your reading experience. It can also be used as a python library.\nCurrently, it supports metaguiding an EPUB, KEPUB, XHTML, or HTML file (more features coming):\n```console\n> intellireading metaguide-epub --input_file mybook.epub --output_file mybook_metaguided.epub\n```\nExample of a text converted to a metaguided text:\n \n\n\nThis repo is part of the [Intellireading](https://intellireading.com/) project, which aims to help people with dyslexia, ADHD, or anyone who wants to improve their reading focus and speed. \n\n## [Other Intellireading Code Repositories](https://github.com/stars/0x6f677548/lists/intellireading)\n- [Intellireading website](https://www.github.com/0x6f677548/intellireading-www), which allows anyone to convert an Epub to the metaguided version.\n- [Backend Servers](https://www.github.com/0x6f677548/intellireading-backend), that support the Intellireading website.\n- [CLI Tool](https://www.github.com/0x6f677548/intellireading-cli). A standalone tool and library that can be used to metaguide epub files.\n- [Calibre Plugins](https://www.github.com/0x6f677548/intellireading-calibre-plugins). A set of plugins that can be used to metaguide epub files using Calibre.\n\n\n## What is Epub Metaguiding?\n**Metagu**iding **i**s **a** **techn**ique **th**at **ca**n **b**e **us**ed **t**o **impr**ove **yo**ur **read**ing **foc**us **an**d **spe**ed **(some**times **cal**led **Bio**nic **Readi**ng). **I**t **i**s **bas**ed **o**n **th**e **id**ea **th**at **yo**u **ca**n **us**e **a** **vis**ual **gui**de **t**o **he**lp **yo**ur **ey**es **foc**us **o**n **th**e **te**xt **yo**u **ar**e **read**ing. **I**n **th**is **cas**e, **th**e **vis**ual **gui**de **i**s **do**ne **b**y **bold**ing **a** **pa**rt **o**f **th**e **tex**t, **crea**ting **vis**ual **anch**ors **th**at **yo**ur **ey**es **ca**n **us**e **t**o **foc**us **o**n **th**e **tex**t. **Th**is **i**s **simi**lar **t**o **th**e **wa**y **a** **fin**ger **ca**n **b**e **us**ed **t**o **gui**de **yo**ur **ey**es **alo**ng **a** **li**ne **o**f **tex**t, **whi**ch **ha**s **be**en **sho**wn **t**o **impr**ove **read**ing **spe**ed **an**d **foc**us. ([**stu**dy: **\"Do**es **finger-t**racking **poi**nt **t**o **chi**ld **read**ing **strate**gies\"](https://ceur-ws.org/Vol-2769/paper_60.pdf))\n\n**Howe**ver, **unl**ike **a** **fing**er, **th**e **vis**ual **gui**de **i**s **no**t **distra**cting, **an**d **i**t **ca**n **b**e **us**ed **t**o **gui**de **yo**ur **ey**es **alo**ng **mult**iple **lin**es **o**f **te**xt **a**t **onc**e. **Th**is **all**ows **yo**u **t**o **re**ad **fast**er, **an**d **wi**th **le**ss **effo**rt.\n\n**Metagu**iding **i**s **partic**ulary **use**ful **fo**r **peo**ple **wi**th **dysl**exia **o**r **ADH**D, **bu**t **i**t **ca**n **b**e **us**ed **b**y **any**one **wh**o **wan**ts **t**o **impr**ove **the**ir **read**ing **foc**us **an**d **spe**ed. **Fo**r **mo**re **inform**ation, **vis**it **th**e [**Intelli**reading **webs**ite.](https://intellireading.com/)\n\n## Features\n\nIntellireading commands can be used to:\n- **Metaguide an EPUB file**: Metaguide an EPUB file, transforming it into a metaguided EPUB file, by transforming all XHTML files in the EPUB file into metaguided XHTML files.\n- **Metaguide an XHTML file**: Metaguide an XHTML file, transforming it into a metaguided XHTML file.\n- **Metaguide a directory**: Metaguide all files in a directory, transforming all EPUB, XHTML, and HTML files into metaguided files.\n\n\n## Installation\nIntellireading is a command line tool that can be used in Windows, Linux, and MacOS. It is written in Python and can be used as a module or as a standalone tool, as long as you have Python >3.7 installed (or Docker).\n\n### pip\nTo install it, you can use pip:\n```console\n> pip install intellireading-cli\n> intellireading --help\n```\n\n### From source code\nYou can also install it from the source code:\n```console\n> git clone https://github.com/0x6f677548/intellireading-cli.git\n> cd intellireading-cli\n> pip install .\n> intellireading --help\n```\n### Docker\nAlternatively, you can use the Docker image:\n\n#### Help command\n```console\n> docker pull ghcr.io/0x6f677548/intellireading-cli:latest\n> docker run -it --rm ghcr.io/0x6f677548/intellireading-cli --help\n```\n\n#### Metaguide an EPUB file\n##### Linux/MacOS\n```console\n```linux\n> docker run -it --rm -v $(pwd)/tests:/tests ghcr.io/0x6f677548/intellireading-cli metaguide-epub --input_file '/tests/test_files/input.epub' --output_file '/tests/test_files/output.epub'\n```\n##### Windows\n```powershell\n> docker run -it --rm -v ${pwd}/tests:/tests ghcr.io/0x6f677548/intellireading-cli metaguide-epub --input_file '/tests/test_files/input.epub' --output_file '/tests/test_files/output.epub'\n```\n\n\n\n## Usage\nAll available commands and options can be seen by using the `--help` option.\n```console\n> intellireading --help\n```\n\nTo get help on a specific command, use the `--help` option with the command name. For example, to get help on the `metaguide-epub` command, use the following command:\n```console\n> intellireading metaguide-epub --help\n```\n\nIntellireading is based on [Click](https://github.com/pallets/click/), taking advantage of its features, such as chaining commands and options. \n\n### Usage Examples\n\n#### Metaguide an EPUB file\nTo metaguide an EPUB file, use the `metaguide-epub` command. The command requires the path to the EPUB file and the output file. The output file will be a metaguided epub file. \n\n```console\n> intellireading metaguide-epub --input_file mybook.epub --output_file mybook_metaguided.epub\n```\n\n#### Metaguide a XHTML file\nTo metaguide an XHTML file, use the `metaguide-xhtml` command. The command requires the path to the XHTML file and the output file. The output file will be a metaguided xhtml file. \n\n```console\n> intellireading metaguide-xhtml --input_file mybook.xhtml --output_file mybook_metaguided.xhtml\n```\n\n#### Metaguide all files in a directory\nTo metaguide all files in a directory, use the `metaguide-dir` command. The command requires the path to the directory and the output directory. The output directory will contain all metaguided files, including epub, xhtml and html files. \n\n```console\n> intellireading metaguide-dir --input_dir mydir --output_dir mydir_metaguided\n```\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Intellireading-cli is a Python library with a set of tools to improve your reading experience",
"version": "2.0.0",
"project_urls": {
"Documentation": "https://github.com/0x6f677548/intellireading-cli#readme",
"Issues": "https://github.com/0x6f677548/intellireading-cli/issues",
"Source": "https://github.com/0x6f677548/intellireading-cli"
},
"split_keywords": [
"adhd",
" calibre",
" dyslexia",
" ebook",
" epub",
" kepub",
" kindle",
" kobo",
" speed-reading"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5cf6e660927906f119b7307ed044b17aa948bf424070d9411d6b3aad31b010bb",
"md5": "da83474d96a529105c07c7f4b3ad881d",
"sha256": "2863390714d01edc6f81eff14400f3b8af4833adcb31ae2bbdb52759ddf398fe"
},
"downloads": -1,
"filename": "intellireading_cli-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "da83474d96a529105c07c7f4b3ad881d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 23219,
"upload_time": "2025-01-19T10:21:07",
"upload_time_iso_8601": "2025-01-19T10:21:07.993194Z",
"url": "https://files.pythonhosted.org/packages/5c/f6/e660927906f119b7307ed044b17aa948bf424070d9411d6b3aad31b010bb/intellireading_cli-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "aa86ad9b40c457326838bcebf56f6a1837894ecbcf8c9dabff13f3b73de07a4c",
"md5": "c0cc43156b9dcd7dce1d1659e126aa92",
"sha256": "084def952393b716f00380e6c9c091841222e795b614bafa38338c55ce5f1ef9"
},
"downloads": -1,
"filename": "intellireading_cli-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "c0cc43156b9dcd7dce1d1659e126aa92",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 21612,
"upload_time": "2025-01-19T10:21:09",
"upload_time_iso_8601": "2025-01-19T10:21:09.962430Z",
"url": "https://files.pythonhosted.org/packages/aa/86/ad9b40c457326838bcebf56f6a1837894ecbcf8c9dabff13f3b73de07a4c/intellireading_cli-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-19 10:21:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "0x6f677548",
"github_project": "intellireading-cli#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "intellireading-cli"
}
JSON
