# 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
### Method1: Download from pip (Recommended)
```shell
pip install qin
```
### Method2: 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
## Get Model Information from Model File (CivitAI)
```shell
qin ai model -p path/to/your/file
```
- `-p`: The path to the file for which you want to retrieve information
## Get Hash of Model File
```shell
qin ai hash -p path/to/your/file
```
- `-p`: The path to the file for which you want to retrieve the hash
## Get preview images of all model files in the current directory and save them by name in the current directory
```shell
qin ai preview -p path/to/the/dir -r
```
- `-p` The path to the folder from which you want to get preview images
- `-r` Whether to recursively include subfolders
## Update all git repositories in a directory
```shell
qin git pull -p path/to/the/dir -r
```
- `-p` The root directory of the git repositories to be updated (if `-p path/to/the/dir` is not specified, the default is the current directory)
- `-r` Whether to recursively update subfolders, default is `False`
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/56/98/aae0ecb64529b0922b679e9accc22763b108dceba88c88ffe5426993f6ba/qin-0.1.3.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### Method1: Download from pip (Recommended)\n\n```shell\npip install qin\n```\n\n### Method2: 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\n## Get Model Information from Model File (CivitAI)\n\n```shell\nqin ai model -p path/to/your/file\n```\n\n- `-p`: The path to the file for which you want to retrieve information\n\n## Get Hash of Model File\n\n```shell\nqin ai hash -p path/to/your/file\n```\n\n- `-p`: The path to the file for which you want to retrieve the hash\n\n## Get preview images of all model files in the current directory and save them by name in the current directory\n\n```shell\nqin ai preview -p path/to/the/dir -r\n```\n\n- `-p` The path to the folder from which you want to get preview images\n- `-r` Whether to recursively include subfolders\n\n## Update all git repositories in a directory\n\n```shell\nqin git pull -p path/to/the/dir -r\n```\n\n- `-p` The root directory of the git repositories to be updated (if `-p path/to/the/dir` is not specified, the default is the current directory)\n- `-r` Whether to recursively update subfolders, default is `False`\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.3",
"project_urls": {
"Homepage": "https://github.com/Alndaly/qin-cli"
},
"split_keywords": [
"pip",
" tools"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "04ad0b2f3229af3f118b86323483de754ac8ab941f58bf368c660daf006bf0c8",
"md5": "b8a9767c826e75d2ff2c7b54e3b28fe1",
"sha256": "168e08c93d59fb57f9e0afd28e059d9ed0e88e97611326c05966919140c87433"
},
"downloads": -1,
"filename": "qin-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b8a9767c826e75d2ff2c7b54e3b28fe1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 11573,
"upload_time": "2024-07-20T08:00:30",
"upload_time_iso_8601": "2024-07-20T08:00:30.617589Z",
"url": "https://files.pythonhosted.org/packages/04/ad/0b2f3229af3f118b86323483de754ac8ab941f58bf368c660daf006bf0c8/qin-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5698aae0ecb64529b0922b679e9accc22763b108dceba88c88ffe5426993f6ba",
"md5": "9442d42cf8eba6f1caf11aaf58da7cb9",
"sha256": "a06d0d3cf8f0fdd563cb79e657ddd5ea666bb65ea97b623a87b676988f9003c9"
},
"downloads": -1,
"filename": "qin-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "9442d42cf8eba6f1caf11aaf58da7cb9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 10563,
"upload_time": "2024-07-20T08:00:31",
"upload_time_iso_8601": "2024-07-20T08:00:31.719811Z",
"url": "https://files.pythonhosted.org/packages/56/98/aae0ecb64529b0922b679e9accc22763b108dceba88c88ffe5426993f6ba/qin-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-20 08:00:31",
"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"
}
JSON
