# Interesting Toolset Script
[中文说明文档](./README/zh-CN.md)
Given the frequent need for various small tools, I plan to create a script library. Currently, it only supports CLI.
> [!warning]
> Since I use a Mac, this project is currently only usable on Mac. Other platforms have not been tested yet. If you encounter any issues, please submit an issue.
> [!note]
> This project relies on ffmpeg. Please ensure ffmpeg is installed locally.
## Some Project Configurations
- The default configuration file is `~/.qin/config.json`.
- The default temporary trash folder is `~/.qin/trash`.
If you need the image upload function of this project, please make sure to configure the `oss` related fields in the `config.json` file.
## Download
### Download from pip (Recommended)
```shell
pip install qin
```
### Clone the Project
```shell
git clone git@github.com:Alndaly/qin-cli.git
cd qin-cli
python setup.py sdist
pip install .
```
## Media File Conversion
```shell
qin media convert -i /usr/test.flac -o /usr/test.mp3
```
- `-i` Source file
- `-o` Converted file
## Download Some Media Files
```shell
qin media download -u https://www.bilibili.com/video/BV117411J719 -f mp3
```
- `-u` Video URL
- `-f` Video format supports mp3/mp4
> If the media file is a video, it will be automatically converted to mp3 format.
## video to gif
```shell
qin media 2gif -i /usr/test.mp4 -o /usr/test.gif
```
- `-i` path of the source video file
- `-o` the path to the gif
## media cutting
```shell
qin media cut -i /usr/test.mp4 -s 10 -e 20 -o /output.mp4
```
- `-i` The path to the file you want to cut
- `-s` The start time of the clip (in seconds)
- `-e` The end time of the clip (in seconds)
- `-o` The path of the cutted file
## File Deletion
```shell
qin file delete -p path/to/dir -i test -r
```
- `-p` Parent root directory of the files to be deleted
- `-r` Whether to recursively delete subfolders
- `-i` The character that must be included in the name of the file to be deleted
- `-f` Whether to delete files directly (default is False, files will be moved to the trash folder)
## Upload Files to Aliyun OSS
```shell
qin file upload -p path/to/your/file
```
- `-p` Path of the file to be uploaded
## Convert PDF to PNG
```shell
qin file pdf2png -p path/to/your/file
```
- `-p` Path to the PDF file to be converted
Raw data
{
"_id": null,
"home_page": "https://github.com/Alndaly/qin-cli",
"name": "qin",
"maintainer": "Kinda Hall",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "1142704468@qq.com",
"keywords": "pip, tools",
"author": "Kinda Hall",
"author_email": "1142704468@qq.com",
"download_url": "https://files.pythonhosted.org/packages/f0/2c/f7d22d21cf4b3f8269f68a1821284b81c278217589d1223790c01a977835/qin-0.1.0.tar.gz",
"platform": "macOS",
"description": "# Interesting Toolset Script\n\n[\u4e2d\u6587\u8bf4\u660e\u6587\u6863](./README/zh-CN.md)\n\nGiven the frequent need for various small tools, I plan to create a script library. Currently, it only supports CLI.\n\n> [!warning]\n> Since I use a Mac, this project is currently only usable on Mac. Other platforms have not been tested yet. If you encounter any issues, please submit an issue.\n\n> [!note]\n> This project relies on ffmpeg. Please ensure ffmpeg is installed locally.\n\n## Some Project Configurations\n\n- The default configuration file is `~/.qin/config.json`.\n- The default temporary trash folder is `~/.qin/trash`.\n\nIf you need the image upload function of this project, please make sure to configure the `oss` related fields in the `config.json` file.\n\n## Download\n\n### Download from pip (Recommended)\n\n```shell\npip install qin\n```\n\n### Clone the Project\n\n```shell\ngit clone git@github.com:Alndaly/qin-cli.git\ncd qin-cli\npython setup.py sdist\npip install .\n```\n\n## Media File Conversion\n\n```shell\nqin media convert -i /usr/test.flac -o /usr/test.mp3\n```\n\n- `-i` Source file\n- `-o` Converted file\n\n## Download Some Media Files\n\n```shell\nqin media download -u https://www.bilibili.com/video/BV117411J719 -f mp3\n```\n\n- `-u` Video URL\n- `-f` Video format supports mp3/mp4\n\n> If the media file is a video, it will be automatically converted to mp3 format.\n\n## video to gif\n\n```shell\nqin media 2gif -i /usr/test.mp4 -o /usr/test.gif\n```\n\n- `-i` path of the source video file\n- `-o` the path to the gif\n\n## media cutting\n\n```shell\nqin media cut -i /usr/test.mp4 -s 10 -e 20 -o /output.mp4\n```\n\n- `-i` The path to the file you want to cut \n- `-s` The start time of the clip (in seconds)\n- `-e` The end time of the clip (in seconds)\n- `-o` The path of the cutted file\n\n## File Deletion\n\n```shell\nqin file delete -p path/to/dir -i test -r\n```\n\n- `-p` Parent root directory of the files to be deleted\n- `-r` Whether to recursively delete subfolders\n- `-i` The character that must be included in the name of the file to be deleted\n- `-f` Whether to delete files directly (default is False, files will be moved to the trash folder)\n\n## Upload Files to Aliyun OSS\n\n```shell\nqin file upload -p path/to/your/file\n```\n\n- `-p` Path of the file to be uploaded\n\n## Convert PDF to PNG\n\n```shell\nqin file pdf2png -p path/to/your/file\n```\n\n- `-p` Path to the PDF file to be converted\n",
"bugtrack_url": null,
"license": "Copyright (c) 2023 Kinda Hall What you can do: - improve the code and send the improvements back to the community - use the code to help you study the subject - use the code as a starting point for your own project What you can't do: - use the code, or any derivative of the code, for any commercial purpose - hold the copyright to the modifications you make to the code - sell the code or any derivative of the code - remove this license information from the code - claim that the code is your original work you may not use the code for any illegal purpose. **NOTE**: You **can not** do any other thing without my permission.",
"summary": "Interesting toolset",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/Alndaly/qin-cli"
},
"split_keywords": [
"pip",
" tools"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a8c480e701a510292e811bfed5bdc9698886930dfb02b9e124246d83f98e420b",
"md5": "479a38ae357aafd1c456f79a4377e255",
"sha256": "bdadd3ec03ad39d8d7ea8bc1fd6346f1ca00ce03437c139cd41437e6931eea14"
},
"downloads": -1,
"filename": "qin-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "479a38ae357aafd1c456f79a4377e255",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9003,
"upload_time": "2024-06-01T15:02:53",
"upload_time_iso_8601": "2024-06-01T15:02:53.704485Z",
"url": "https://files.pythonhosted.org/packages/a8/c4/80e701a510292e811bfed5bdc9698886930dfb02b9e124246d83f98e420b/qin-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f02cf7d22d21cf4b3f8269f68a1821284b81c278217589d1223790c01a977835",
"md5": "67be956964638c745e01735767d2c1a7",
"sha256": "b9deb7ff97741eba965fec04ef0eb0e24bcd58b906761e91e84b6c833174ba7f"
},
"downloads": -1,
"filename": "qin-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "67be956964638c745e01735767d2c1a7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 8661,
"upload_time": "2024-06-01T15:02:54",
"upload_time_iso_8601": "2024-06-01T15:02:54.790802Z",
"url": "https://files.pythonhosted.org/packages/f0/2c/f7d22d21cf4b3f8269f68a1821284b81c278217589d1223790c01a977835/qin-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-01 15:02:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Alndaly",
"github_project": "qin-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "qin"
}