ebay_pictures

Name	ebay_pictures_tool JSON
Version	0.0.95 JSON
	download
home_page
Summary	An efficient tool for processing ebay images.
upload_time	2023-08-27 19:38:19
maintainer
docs_url	None
author	Chris Busillo
requires_python	>=3.11,<3.12
license
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

# eBay Pictures Tool

The eBay Pictures Tool is a purpose-built application designed to streamline the image processing workflow for eBay listings. With
the added functionality to integrate with the Odoo ERP system, users can seamlessly handle images for their listings.

## Features

- **Image Processing**: Specifically tailored for eBay listings to ensure images fit eBay's recommended standards.
- **Odoo Integration**: Offers an option to automatically upload processed images directly to your Odoo instance.
- **User-friendly Interface**:Simple and intuitive setup and processing steps.

## Installation

### Prerequisites

The tool requires macOS Monterey or newer. If you're using an older version of macOS, the tool might not function as intended.

1. **Installation Command**:

Open a terminal and run the following command:
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/cbusillo/ebay_pictures_tool/main/installer.sh)"
```
This command will download and execute the installation script from our GitHub repository.
This installation might take some time, so please be patient. During the process, you might be prompted to enter your user
password.

Note: If the installation script indicates that the required developer tools are missing with an error message like:
```
xcode-select: note: no developer tools were found at `Applications/Xcode.app`, requesting install.
```
A dialog will prompt you to install the necessary tools. Click "Install" and once the installation is complete, you can continue
with the eBay Pictures Tool installation.

**Important**: After the installation is complete, please log out of your macOS user account and log back in to ensure that all
features of the eBay Pictures Tool operate correctly.

2. **Odoo Configuration**:

Once the eBay Pictures Tool is installed, it will execute and set up the environment. For integration with Odoo, configure
the `secret.json` file located at `~/.shiny/secret.json`:

- **Password**: To create an API Key, navigate to your Odoo instance, click your profile name at the top right, go to the "Account
Security" tab, and select "NEW API KEY".

![API_Key_Screenshot.png](images/API_Key_Screenshot.png)

- **Username**: Typically your Odoo username, which is often your email address.
- **Database Name**: Activate the developer mode in Odoo. Once it's active, the database name is displayed near your username at
the top right.
- **URL**: The base URL for your Odoo instance (e.g., "http://shop.yourdomain.com").

Your configuration should resemble:
```json
{
"odoo_url": "Website URL",
"odoo_db": "Database Name",
"odoo_username": "info@blah.com",
"odoo_password": "PASSWORD"
}
```

## Usage Guide

To use the `ebay_pictures_tool`, you can run it directly from the terminal. The tool accepts various arguments to customize its
behavior, as detailed below.

1. **Basic Command**:

```
ebay_pictures_tool
```
This will execute the tool with its default settings.

2. **Arguments**:

- `-s` or `--sd_card_path`: Path to your SD card.
- **Default**: `/Volumes/EOS_DIGITAL` (or `~/Desktop/Input` if in testing mode)
```
ebay_pictures_tool -s /path/to/sd/card
```

- `-o` or `--output_path`: Path to the directory where you want to save the processed images.
- **Default**: `~/Desktop/eBay Pics`
```
ebay_pictures_tool -o /path/to/output/directory
```

- `-t` or `--trimmed_output_path`: Path to the directory where trimmed images will be saved.
- **Default**: `~/Desktop/eBay Pics/Trimmed`
```
ebay_pictures_tool -t /path/to/trimmed/output/directory
```

- `-n` or `--nb_output_path`: Path to the directory where images without a background will be saved.
- **Default**: `~/Desktop/eBay Pics/NB`
```
ebay_pictures_tool -n /path/to/no/background/output/directory
```

- `-b` or `--background_color`: Sets the background color for trimmed images in (R,G,B) format.
- **Default**: `255,255,255`
```
ebay_pictures_tool -b 255,255,255
```

- `-m` or `--model_name`: Model name to use for background removal.
- **Default**: `isnet-general-use`
- `isnet-general-use`: This model is optimal for cleanly cutting out the primary object, but it will remove everything
except the main subject.
- `u2net`: This model doesn't cut as cleanly as `isnet-general-use`, but retains smaller parts in the pictures, such as
screws or other minor details.
```
ebay_pictures_tool -m model_name
```

You can combine multiple arguments in one command. For example, if you want to specify both the SD card path and the output
directory, you can run:

```
ebay_pictures_tool -s /path/to/sd/card -o /path/to/output/directory
```

For a complete list of options and their descriptions, you can run:

```
ebay_pictures_tool --help
```

## Troubleshooting

Run the script a second time if it fails the first time. It may be intermittent connectivity issues. Make sure to log out after a
successful installation.

## Contributing and Feedback

Encountered any issues, have feature requests, or any other feedback? Please open an issue on
our [GitHub repository](https://github.com/cbusillo/ebay_pictures_tool).

## License

No idea

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "ebay_pictures_tool",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.11,<3.12",
    "maintainer_email": "",
    "keywords": "",
    "author": "Chris Busillo",
    "author_email": "cbusillo@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/1a/f9/0788dd8986043b341407d88097f898a1065c48213b55f4a1d39377d1c2cc/ebay_pictures_tool-0.0.95.tar.gz",
    "platform": null,
    "description": "# eBay Pictures Tool\n\nThe eBay Pictures Tool is a purpose-built application designed to streamline the image processing workflow for eBay listings. With\nthe added functionality to integrate with the Odoo ERP system, users can seamlessly handle images for their listings.\n\n## Features\n\n- **Image Processing**: Specifically tailored for eBay listings to ensure images fit eBay's recommended standards.\n- **Odoo Integration**: Offers an option to automatically upload processed images directly to your Odoo instance.\n- **User-friendly Interface**:Simple and intuitive setup and processing steps.\n\n## Installation\n\n### Prerequisites\n\nThe tool requires macOS Monterey or newer. If you're using an older version of macOS, the tool might not function as intended.\n\n1. **Installation Command**:\n\n   Open a terminal and run the following command:\n   ```bash\n   /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/cbusillo/ebay_pictures_tool/main/installer.sh)\"\n   ```\n   This command will download and execute the installation script from our GitHub repository.\n   This installation might take some time, so please be patient. During the process, you might be prompted to enter your user\n   password.\n\n   Note: If the installation script indicates that the required developer tools are missing with an error message like:\n   ```\n   xcode-select: note: no developer tools were found at `Applications/Xcode.app`, requesting install.\n   ```\n   A dialog will prompt you to install the necessary tools. Click \"Install\" and once the installation is complete, you can continue\n   with the eBay Pictures Tool installation.\n\n   **Important**: After the installation is complete, please log out of your macOS user account and log back in to ensure that all\n   features of the eBay Pictures Tool operate correctly.\n\n2. **Odoo Configuration**:\n\n   Once the eBay Pictures Tool is installed, it will execute and set up the environment. For integration with Odoo, configure\n   the `secret.json` file located at `~/.shiny/secret.json`:\n\n   - **Password**: To create an API Key, navigate to your Odoo instance, click your profile name at the top right, go to the \"Account\n     Security\" tab, and select \"NEW API KEY\".\n\n     ![API_Key_Screenshot.png](images/API_Key_Screenshot.png)\n\n   - **Username**: Typically your Odoo username, which is often your email address.\n   - **Database Name**: Activate the developer mode in Odoo. Once it's active, the database name is displayed near your username at\n     the top right.\n   - **URL**: The base URL for your Odoo instance (e.g., \"http://shop.yourdomain.com\").\n\n   Your configuration should resemble:\n   ```json\n   {\n       \"odoo_url\": \"Website URL\",\n       \"odoo_db\": \"Database Name\",\n       \"odoo_username\": \"info@blah.com\",\n       \"odoo_password\": \"PASSWORD\"\n   }\n   ```\n\n## Usage Guide\n\nTo use the `ebay_pictures_tool`, you can run it directly from the terminal. The tool accepts various arguments to customize its\nbehavior, as detailed below.\n\n1. **Basic Command**:\n\n    ```\n    ebay_pictures_tool\n    ```\n   This will execute the tool with its default settings.\n\n2. **Arguments**:\n\n- `-s` or `--sd_card_path`: Path to your SD card.\n    - **Default**: `/Volumes/EOS_DIGITAL` (or `~/Desktop/Input` if in testing mode)\n  ```\n  ebay_pictures_tool -s /path/to/sd/card\n  ```\n\n- `-o` or `--output_path`: Path to the directory where you want to save the processed images.\n    - **Default**: `~/Desktop/eBay Pics`\n  ```\n  ebay_pictures_tool -o /path/to/output/directory\n  ```\n\n- `-t` or `--trimmed_output_path`: Path to the directory where trimmed images will be saved.\n    - **Default**: `~/Desktop/eBay Pics/Trimmed`\n  ```\n  ebay_pictures_tool -t /path/to/trimmed/output/directory\n  ```\n\n- `-n` or `--nb_output_path`: Path to the directory where images without a background will be saved.\n    - **Default**: `~/Desktop/eBay Pics/NB`\n  ```\n  ebay_pictures_tool -n /path/to/no/background/output/directory\n  ```\n\n- `-b` or `--background_color`: Sets the background color for trimmed images in (R,G,B) format.\n    - **Default**: `255,255,255`\n  ```\n  ebay_pictures_tool -b 255,255,255\n  ```\n\n- `-m` or `--model_name`: Model name to use for background removal.\n    - **Default**: `isnet-general-use`\n        - `isnet-general-use`: This model is optimal for cleanly cutting out the primary object, but it will remove everything\n          except the main subject.\n        - `u2net`: This model doesn't cut as cleanly as `isnet-general-use`, but retains smaller parts in the pictures, such as\n          screws or other minor details.\n  ```\n  ebay_pictures_tool -m model_name\n  ```\n\nYou can combine multiple arguments in one command. For example, if you want to specify both the SD card path and the output\ndirectory, you can run:\n\n```\nebay_pictures_tool -s /path/to/sd/card -o /path/to/output/directory\n```\n\nFor a complete list of options and their descriptions, you can run:\n\n```\nebay_pictures_tool --help\n```\n\n## Troubleshooting\n\nRun the script a second time if it fails the first time. It may be intermittent connectivity issues. Make sure to log out after a\nsuccessful installation.\n\n## Contributing and Feedback\n\nEncountered any issues, have feature requests, or any other feedback? Please open an issue on\nour [GitHub repository](https://github.com/cbusillo/ebay_pictures_tool).\n\n## License\n\nNo idea\n\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "An efficient tool for processing ebay images.",
    "version": "0.0.95",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e15dfa45fbd5f040be9e9e42b2ac782cfdd4a54a244411fcd34c350265c788f0",
                "md5": "d0796f035bc5dcd273fbff183fdafdfa",
                "sha256": "c202a6dd664b36082762295284a0ced62d5f2bed62ef8a4aa60c71b32b6e4348"
            },
            "downloads": -1,
            "filename": "ebay_pictures_tool-0.0.95-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d0796f035bc5dcd273fbff183fdafdfa",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11,<3.12",
            "size": 10070,
            "upload_time": "2023-08-27T19:38:17",
            "upload_time_iso_8601": "2023-08-27T19:38:17.757473Z",
            "url": "https://files.pythonhosted.org/packages/e1/5d/fa45fbd5f040be9e9e42b2ac782cfdd4a54a244411fcd34c350265c788f0/ebay_pictures_tool-0.0.95-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1af90788dd8986043b341407d88097f898a1065c48213b55f4a1d39377d1c2cc",
                "md5": "6147a32559eb04896abec63b6caf4f92",
                "sha256": "ae97692e19275e46c7a89301acecee6b1379366f2dd14b940e26201a6c6acc28"
            },
            "downloads": -1,
            "filename": "ebay_pictures_tool-0.0.95.tar.gz",
            "has_sig": false,
            "md5_digest": "6147a32559eb04896abec63b6caf4f92",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11,<3.12",
            "size": 10523,
            "upload_time": "2023-08-27T19:38:19",
            "upload_time_iso_8601": "2023-08-27T19:38:19.219476Z",
            "url": "https://files.pythonhosted.org/packages/1a/f9/0788dd8986043b341407d88097f898a1065c48213b55f4a1d39377d1c2cc/ebay_pictures_tool-0.0.95.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-27 19:38:19",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "ebay_pictures_tool"
}

Chris Busillo