# A *C*ommand *L*ine *I*nterface to the TGBOX
This is a [**CLI**](https://en.wikipedia.org/wiki/Command-line_interface) implementation of the [**TGBOX**](https://github.com/NonProjects/tgbox/) — an encrypted cloud storage built around the [**Telegram**](https://telegram.org).
## Installation
To *build* the **TGBOX-CLI** you will need to have **at least** Python 3.8.
### Windows builds (.EXE)
You can use already created executable builds if you're on Windows.\
See [**Releases GitHub page**](https://github.com/NotStatilko/tgbox-cli/releases) or navigate to the [**official TGBOX dev.channel**](https://t.me/nontgbox)
### Build the TGBOX-CLI
To make all features work, you will also need the [**FFmpeg**](https://ffmpeg.org/download.html) installed in your system (it should\
be also accessible by the simple ``ffmpeg`` command from your Terminal, in other words: in ``PATH``).
#### Install with PIP
You can install latest *stable* release of the ``tgbox-cli`` from [PyPI](https://pypi.org/project/tgbox-cli):
```bash
# Drop [fast] to obtain *slow*, pure-Python build
pip install -U tgbox-cli[fast]
```
#### Clone & Install
Alternatively, you can clone this repository and build from the source. This may give you more control over the code:
```bash
python -m venv tgbox-cli-env
cd tgbox-cli-env && . bin/activate
git clone https://github.com/NotStatilko/tgbox-cli
pip install ./tgbox-cli[fast]
```
#### PyInstaller
If you want to make your own .EXE build *with FFmpeg*, you *will need* to download\
it and place inside the ``tgbox/other`` directory (on Windows only). See this:
```bash
python -m venv tgbox-cli-env
cd tgbox-cli-env && . bin/activate
pip install pyinstaller
git clone https://github.com/NonProjects/tgbox
cd tgbox/tgbox/other # Make sure to place here ffmpeg.exe
```
(after you dropped the ``ffmpeg.exe`` to the ``tgbox/other``):
```bash
cd ../../.. # Move back
pip install ./tgbox[fast]
git clone https://github.com/NotStatilko/tgbox-cli
pip install ./tgbox-cli[fast]
cd tgbox-cli/pyinstaller
pyinstaller tgbox_cli.spec
# Run the executable and show info
dist/tgbox-cli.exe cli-info
```
**Please note** that You can also set `TGBOX_CLI_NON_ONEFILE` env variable to build without packing \
into one executable file & feel free to remove the ``tgbox-cli-env`` folder after work was done.
## Usage
The TGBOX-CLI is a typical Command-Line application. After install, it can be ran as follows:
```bash
tgbox-cli
```
This should output you a list of **commands**. The **help** command will give you a full course over **TGBOX-CLI**.\
Use it (as well as ``--help`` *option* on every **command**) if you don't know anything about this application:
```bash
tgbox-cli help
```
## Bug reports
Feel free to report some problems (i believe there can be many) on the [**GitHub Issue tab**](https://github.com/NotStatilko/tgbox-cli/issues). Any encountered error should be written to the logfile. Use the **logfile-open** command and **attach** its content to the bug report.
**Thanks**.
Raw data
{
"_id": null,
"home_page": "https://github.com/NotStatilko/tgbox-cli",
"name": "tgbox-cli",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Telegram, Cloud-Storage, Cloud, Non-official",
"author": "NotStatilko",
"author_email": "thenonproton@pm.me",
"download_url": "https://files.pythonhosted.org/packages/24/f8/a83e8c7734b2517ad7819ac5fa47772d637dbe7da53fd3972e9d4017e9bb/tgbox-cli-1.4.tar.gz",
"platform": null,
"description": "# A *C*ommand *L*ine *I*nterface to the TGBOX\n\nThis is a [**CLI**](https://en.wikipedia.org/wiki/Command-line_interface) implementation of the [**TGBOX**](https://github.com/NonProjects/tgbox/) \u2014 an encrypted cloud storage built around the [**Telegram**](https://telegram.org).\n\n\n## Installation\n\nTo *build* the **TGBOX-CLI** you will need to have **at least** Python 3.8.\n\n### Windows builds (.EXE)\n\nYou can use already created executable builds if you're on Windows.\\\nSee [**Releases GitHub page**](https://github.com/NotStatilko/tgbox-cli/releases) or navigate to the [**official TGBOX dev.channel**](https://t.me/nontgbox)\n\n### Build the TGBOX-CLI\n\nTo make all features work, you will also need the [**FFmpeg**](https://ffmpeg.org/download.html) installed in your system (it should\\\nbe also accessible by the simple ``ffmpeg`` command from your Terminal, in other words: in ``PATH``).\n\n#### Install with PIP\n\nYou can install latest *stable* release of the ``tgbox-cli`` from [PyPI](https://pypi.org/project/tgbox-cli):\n```bash\n# Drop [fast] to obtain *slow*, pure-Python build\npip install -U tgbox-cli[fast]\n```\n\n#### Clone & Install\n\nAlternatively, you can clone this repository and build from the source. This may give you more control over the code:\n```bash\npython -m venv tgbox-cli-env\ncd tgbox-cli-env && . bin/activate\n\ngit clone https://github.com/NotStatilko/tgbox-cli\npip install ./tgbox-cli[fast]\n```\n#### PyInstaller\n\nIf you want to make your own .EXE build *with FFmpeg*, you *will need* to download\\\nit and place inside the ``tgbox/other`` directory (on Windows only). See this:\n```bash\npython -m venv tgbox-cli-env\ncd tgbox-cli-env && . bin/activate\n\npip install pyinstaller\n\ngit clone https://github.com/NonProjects/tgbox\ncd tgbox/tgbox/other # Make sure to place here ffmpeg.exe\n```\n(after you dropped the ``ffmpeg.exe`` to the ``tgbox/other``):\n```bash\ncd ../../.. # Move back\npip install ./tgbox[fast]\n\ngit clone https://github.com/NotStatilko/tgbox-cli\npip install ./tgbox-cli[fast]\n\ncd tgbox-cli/pyinstaller\npyinstaller tgbox_cli.spec\n\n# Run the executable and show info\ndist/tgbox-cli.exe cli-info\n```\n**Please note** that You can also set `TGBOX_CLI_NON_ONEFILE` env variable to build without packing \\\ninto one executable file & feel free to remove the ``tgbox-cli-env`` folder after work was done.\n\n## Usage\n\nThe TGBOX-CLI is a typical Command-Line application. After install, it can be ran as follows:\n```bash\ntgbox-cli\n```\nThis should output you a list of **commands**. The **help** command will give you a full course over **TGBOX-CLI**.\\\nUse it (as well as ``--help`` *option* on every **command**) if you don't know anything about this application:\n```bash\ntgbox-cli help\n```\n\n## Bug reports\n\nFeel free to report some problems (i believe there can be many) on the [**GitHub Issue tab**](https://github.com/NotStatilko/tgbox-cli/issues). Any encountered error should be written to the logfile. Use the **logfile-open** command and **attach** its content to the bug report.\n\n**Thanks**.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Command Line Interface to the TGBOX",
"version": "1.4",
"project_urls": {
"Download": "https://github.com/NotStatilko/tgbox-cli/archive/refs/tags/v1.4.tar.gz",
"Homepage": "https://github.com/NotStatilko/tgbox-cli"
},
"split_keywords": [
"telegram",
" cloud-storage",
" cloud",
" non-official"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4582cfa569ecfd9cc2741824bfc8d21d5c105cae09a559e9e9158bc567987bb3",
"md5": "e769d838cea3a950a0c7eabd540ce8c2",
"sha256": "208a1b29d944d679ac3250bde45342701462b33ea7ecf068eda791acfbec62b5"
},
"downloads": -1,
"filename": "tgbox_cli-1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e769d838cea3a950a0c7eabd540ce8c2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 65336,
"upload_time": "2024-12-11T17:08:28",
"upload_time_iso_8601": "2024-12-11T17:08:28.231405Z",
"url": "https://files.pythonhosted.org/packages/45/82/cfa569ecfd9cc2741824bfc8d21d5c105cae09a559e9e9158bc567987bb3/tgbox_cli-1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "24f8a83e8c7734b2517ad7819ac5fa47772d637dbe7da53fd3972e9d4017e9bb",
"md5": "05a0852c422651ff75aa28ebef18014e",
"sha256": "e267030bd82215449bd982b64acb19d48d8f471df65b967657cadc1fdcfeb241"
},
"downloads": -1,
"filename": "tgbox-cli-1.4.tar.gz",
"has_sig": false,
"md5_digest": "05a0852c422651ff75aa28ebef18014e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 66596,
"upload_time": "2024-12-11T17:08:30",
"upload_time_iso_8601": "2024-12-11T17:08:30.916733Z",
"url": "https://files.pythonhosted.org/packages/24/f8/a83e8c7734b2517ad7819ac5fa47772d637dbe7da53fd3972e9d4017e9bb/tgbox-cli-1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-11 17:08:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NotStatilko",
"github_project": "tgbox-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tgbox-cli"
}
JSON
