Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yisuschrist/iltransfer
Transfer your Instaloader downloads to another path
https://github.com/yisuschrist/iltransfer
instagram instaloader python
Last synced: about 9 hours ago
JSON representation
Transfer your Instaloader downloads to another path
- Host: GitHub
- URL: https://github.com/yisuschrist/iltransfer
- Owner: YisusChrist
- License: gpl-3.0
- Created: 2023-09-17T22:18:30.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-16T17:12:17.000Z (3 days ago)
- Last Synced: 2024-11-16T18:17:49.926Z (3 days ago)
- Topics: instagram, instaloader, python
- Language: Python
- Homepage:
- Size: 511 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Report Bug
·
Request Feature
·
Ask Question
·
Report security bug
`Iltransfer` (InstaLoader transfer) is a versatile Python application that streamlines the management of Instagram profile downloads using the [Instaloader](https://github.com/instaloader/instaloader) tool. With this program, you can effortlessly:
- Transfer downloaded profiles to another destination when they are ready
- Filter and move only the completed profiles, leaving incomplete downloads untouched.
`Iltransfer` is compatible with Windows, Linux and macOS, and it works seamlessly with Python 3.6 and above. Simplify your Instagram profile management with `Iltransfer` today!
Table of Contents
- [Requirements](#requirements)
- [Installation](#installation)
- [From PyPI](#from-pypi)
- [Manual installation](#manual-installation)
- [Uninstall](#uninstall)
- [Usage](#usage)
- [Example of execution](#example-of-execution)
- [Contributors](#contributors)
- [How do I contribute to iltransfer?](#how-do-i-contribute-to-iltransfer)
- [License](#license)
- [TODO](#todo)
## Requirements
Here's a breakdown of the packages needed and their versions:
- [platformdirs](https://pypi.org/project/platformdirs) - 3.10.0
- [rich](https://pypi.org/project/rich) - 13.5.2
- [rich-argparse-plus](https://pypi.org/project/rich-argparse-plus) - 0.3.1.4
- [tqdm](https://pypi.org/project/tqdm) - 4.66.1
> [!NOTE]
> The software has been developed and tested using Python `3.12.1`. The minimum required version to run the software is Python 3.6. Although the software may work with previous versions, it is not guaranteed.
## Installation
### From PyPI
`iltransfer` can be installed easily as a PypI package. Just run the following command:
```bash
pip3 install iltransfer
```
> [!IMPORTANT]
> For best practices and to avoid potential conflicts with your global Python environment, it is strongly recommended to install this program within a virtual environment. Avoid using the --user option for global installations. We highly recommend using [pipx](https://pypi.org/project/pipx) for a safe and isolated installation experience. Therefore, the appropriate command to install `iltransfer` would be:
>
> ```bash
> pipx install iltransfer
> ```
The program can now be ran from a terminal with the `iltransfer` command.
### Manual installation
If you prefer to install the program manually, follow these steps:
> [!WARNING]
> This will install the version from the latest commit, not the latest release.
1. Download the latest version of [iltransfer](https://github.com/YisusChrist/iltransfer) from this repository:
```bash
git clone https://github.com/YisusChrist/mal_organizer
cd mal_organizer
```
2. Install the package:
```bash
poetry install --only-main
```
3. Run the program:
```bash
poetry run iltransfer
```
The program can now be ran from a terminal with the `iltransfer` command.
### Uninstall
If you installed it from PyPI, you can use the following command:
```bash
pipx uninstall iltransfer
```
## Usage
> [!TIP]
> For more information about the usage of the program, run `iltransfer --help` or `iltransfer -h`.
### Example of execution
## Contributors
### How do I contribute to iltransfer?
Before you participate in our delightful community, please read the [code of conduct](https://github.com/YisusChrist/.github/blob/main/CODE_OF_CONDUCT.md).
I'm far from being an expert and suspect there are many ways to improve – if you have ideas on how to make the configuration easier to maintain (and faster), don't hesitate to fork and send pull requests!
We also need people to test out pull requests. So take a look through [the open issues](https://github.com/YisusChrist/iltransfer/issues) and help where you can.
See [Contributing Guidelines](https://github.com/YisusChrist/.github/blob/main/CONTRIBUTING.md) for more details.
## License
`iltransfer` is released under the [GPL-3.0 License](https://opensource.org/license/GPL-3.0).
## TODO
Planing to add the following features:
- [x] Add a support to use config files (multi-platform) to store the options
- [ ] Add a full documentation in Wiki section
- [x] Add a Changelog / Release Notes