{"id":15694470,"url":"https://github.com/punchagan/igzen","last_synced_at":"2025-05-08T21:16:22.293Z","repository":{"id":138883827,"uuid":"237614644","full_name":"punchagan/IGZen","owner":"punchagan","description":"Post to Instagram, Zen style","archived":false,"fork":false,"pushed_at":"2020-02-01T15:28:04.000Z","size":21,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-08T21:16:17.945Z","etag":null,"topics":["automation","cli","instagram","instagram-uploader","selenium","zen"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/punchagan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-01T12:53:17.000Z","updated_at":"2024-10-13T17:58:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"2c333da3-bec6-41f6-b027-05c10bfe44fa","html_url":"https://github.com/punchagan/IGZen","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/punchagan%2FIGZen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/punchagan%2FIGZen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/punchagan%2FIGZen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/punchagan%2FIGZen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/punchagan","download_url":"https://codeload.github.com/punchagan/IGZen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253149620,"owners_count":21861740,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","cli","instagram","instagram-uploader","selenium","zen"],"created_at":"2024-10-03T18:59:04.987Z","updated_at":"2025-05-08T21:16:22.274Z","avatar_url":"https://github.com/punchagan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IGZen\n\n## Motivation\n\nMy sports team needs me to upload pictures to Instagram for accountability,\nmotivation for team mates, marketing, etc. I don't wish to have the app\ninstalled on my phone, and end-up spending time endlessly scrolling my feed.\nInstagram doesn't allow uploading pictures from their web site on a Desktop.\n\nI tried using the Desktop browser with mobile emulation (or a mobile User\nAgent), but the upload experience was pretty bad - you can't pre-process images\nbefore uploading them if you don't have a touch screen.\n\n`igzen` lets me pre-process the image using a Python+Tkinter based viewer, and\nthen uses selenium to post the images.\n\n## Usage\n\n```sh\n\n# Set INSTAGRAM_USERNAME, INSTAGRAM_PASSWORD environment variables\n$ export INSTAGRAM_USERNAME=\"foobar\"\n$ export INSTAGRAM_PASSWORD=\"passwordyo!\"\n\n# Install the requirements\n$ pip install -r requirements.txt\n\n# Run the main script\n$ python main.py --crop \u003cpath-to-image\u003e \"caption with #hashtags\"\n\n```\n\nIn the image viewer/cropper, you can click anywhere and draw a square to crop\nthe image. Hit `SPACE` to actually save the current crop to disk. Hit `q` to\nclose the image editor, and your browser should automatically open up.\n\nYou could pass the `--share` argument to completely automate the process, and\nnot requiring to even click the share button at the end. If it makes you anxious\nto post without any manual checks, don't use this flag.\n\n*NOTE*: The tool uses `pyautogui` to select the image to upload, after signing\ninto Instagram. You need to make sure that the browser window opened by the tool\nis the focused window, for everything to work as expected!\n\n![igzen](https://user-images.githubusercontent.com/315678/73592597-1ca4fa00-4522-11ea-8cbe-1dcbb3120a85.gif)\n\nHappy Instagramming!\n\n## The Name\n\nIGZen stands for Instagram Zen. Zen could be a reference to the simplicity of\nthe tool. It could also refer to the fact that this tool lets you post stuff to\nInstagram, without getting sucked into the timeline and letting it eat away into\nyour focus time.\n\n## LICENSE\n\nThis tool is licensed under GPLv3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpunchagan%2Figzen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpunchagan%2Figzen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpunchagan%2Figzen/lists"}