{"id":17223513,"url":"https://github.com/davidy22/skunkbooth","last_synced_at":"2025-09-08T14:35:06.318Z","repository":{"id":40238663,"uuid":"384462742","full_name":"Davidy22/SkunkBooth","owner":"Davidy22","description":"Text based command line webcam photobooth app","archived":false,"fork":false,"pushed_at":"2021-12-17T01:15:52.000Z","size":2551,"stargazers_count":51,"open_issues_count":10,"forks_count":12,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-25T02:34:43.922Z","etag":null,"topics":["ascii-art","command-line","hacktoberfest","photobooth","python","text-based","webcam"],"latest_commit_sha":null,"homepage":"https://Davidy22.github.io/SkunkBooth/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Davidy22.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-09T14:31:13.000Z","updated_at":"2025-07-10T04:17:23.000Z","dependencies_parsed_at":"2022-06-27T05:04:02.170Z","dependency_job_id":null,"html_url":"https://github.com/Davidy22/SkunkBooth","commit_stats":null,"previous_names":["davidy22/scholarlyskunkjam"],"tags_count":2,"template":false,"template_full_name":"python-discord/code-jam-template","purl":"pkg:github/Davidy22/SkunkBooth","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Davidy22%2FSkunkBooth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Davidy22%2FSkunkBooth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Davidy22%2FSkunkBooth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Davidy22%2FSkunkBooth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Davidy22","download_url":"https://codeload.github.com/Davidy22/SkunkBooth/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Davidy22%2FSkunkBooth/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268464887,"owners_count":24254199,"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","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ascii-art","command-line","hacktoberfest","photobooth","python","text-based","webcam"],"created_at":"2024-10-15T04:08:31.152Z","updated_at":"2025-08-02T22:08:11.189Z","avatar_url":"https://github.com/Davidy22.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n   \u003cimg src=\"Images/skunkbooth_readme.png\" alt=\"Skunkbooth Logo\" width=\"143\" height=\"143\"\u003e\n   \u003cbr/\u003e\n   \u003cbr/\u003e\n\u003c/div\u003e\n\n[![GitHub issues](https://img.shields.io/github/issues/Davidy22/scholarlySkunkJam?style=for-the-badge)](https://github.com/Davidy22/scholarlySkunkJam/issues) \u0026nbsp;\u0026nbsp; [![GitHub forks](https://img.shields.io/github/forks/Davidy22/scholarlySkunkJam?style=for-the-badge)](https://github.com/Davidy22/scholarlySkunkJam/network) \u0026nbsp;\u0026nbsp; [![GitHub stars](https://img.shields.io/github/stars/Davidy22/scholarlySkunkJam?style=for-the-badge)](https://github.com/Davidy22/scholarlySkunkJam/stargazers)\u0026nbsp;\u0026nbsp; [![PyPI](https://img.shields.io/badge/PyPI-GO%20HERE-yellow?style=for-the-badge\u0026logo=pypi)](https://pypi.org/project/skunkbooth/) \u0026nbsp;\u0026nbsp; [![Python](https://img.shields.io/badge/Python-TRUE-brightgreen?style=for-the-badge\u0026logo=python)](https://www.google.com/url?sa=t\u0026rct=j\u0026q=\u0026esrc=s\u0026source=web\u0026cd=\u0026cad=rja\u0026uact=8\u0026ved=2ahUKEwimlcXOwPHxAhXt4nMBHR1LDBUQFjAAegQICxAD\u0026url=https%3A%2F%2Fwww.python.org%2F\u0026usg=AOvVaw0QREvGsjwHKp2GtoYvs1JH)\u0026nbsp;\u0026nbsp; [![Gitter](https://img.shields.io/gitter/room/SkunkBooth/community.svg?style=for-the-badge\u0026logo=gitter)](https://gitter.im/SkunkBooth/community?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge)\n\n- [Skunkbooth](#skunkbooth)\n  - [Why](#why)\n  - [See it in action](#see-it-in-action)\n- [Usage](#usage)\n  - [Installation](#installation)\n  - [Run](#run)\n  - [Media location](#media-location)\n- [Contributing](#contributing)\n  - [Install Poetry](#install-poetry)\n  - [Clone the repo](#clone-the-repo)\n  - [Activate poetry shell](#activate-poetry-shell)\n  - [Install dev deps](#install-dev-deps)\n  - [Run the application](#run-the-application)\n  - [Logs](#logs)\n- [App Walkthrough](#app-walkthrough)\n  - [Home](#-home)\n  - [Shoot](#-shoot)\n  - [Record](#-record)\n  - [Effects](#-effects)\n  - [Gallery](#-gallery)\n  - [Preview](#-preview)\n  - [Quit](#-quit)\n\n# Skunkbooth\n\nA camera app in terminal. One more reason to stay inside the box you call terminal.\n\n### Why\n\nWith our revolutionary application, you don’t have to leave your terminal and climb a mountain,\njust to get your next perfect Instagram picture.\nOpen terminal, run `skunkbooth` and capture funkiest images _inside_ the box (aka terminal).\n\nWe support all the modern operating systems. All you need is `python3`.\n\n### See it in action\n\n[![ad](https://img.youtube.com/vi/47_HYQGqVIU/0.jpg)](https://www.youtube.com/watch?v=47_HYQGqVIU)\n\n# Usage\n\n### Installation\n\n```shell\npip install skunkbooth\n```\n\n### Run\n\nAfter installation, use `skunkbooth` command to launch camera.\n\n```shell\nskunkbooth\n```\n\n### Media location\n\nThe photos and videos that you take are present in the following location\n\n- MacOS and Linux\n\n```shell\nls ~/skunkbooth/pictures\n```\n\n- Windows\n\n```powershell\ndir C:\\Users\\\u003cusername\u003e\\skunkbooth\\pictures\n```\n\n# Contributing\n\n[Poetry](https://python-poetry.org/) is used for package management.\nFor setting up your environment, follow along.\n\n### Install Poetry\n\n- MacOS, Linux or WSL\n\n```shell\ncurl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py | python -\n```\n\n- Windows Powershell\n\n```shell\n(Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py -UseBasicParsing).Content | python -\n```\n\n### Clone the repo\n\n```shell\ngit clone https://github.com/Davidy22/SkunkBooth.git\ncd SkunkBooth\n```\n\n### Activate poetry shell\n\n```shell\npoetry shell\n```\n\n### Install dev deps\n\n```shell\npoetry install\n```\n\n### Run the application\n\n```shell\npython3 -m skunkbooth.main\n```\n\n### Logs\n\nLogs are located in `skunkbooth` folder.\n\n- macOS and Linux\n\n```shell\ntail -f ~/skunkbooth/.logs/skunkbooth.log\n```\n\n- Windows (powershell)\n\n```powershell\nGet-Content C:\\Users\\\u003cusername\u003e\\skunkbooth\\.logs\\skunkbooth.log -Wait\n```\n\n# App Walkthrough\n\n### 🏠 Home\n\nHome screen is the first point of contact for the application. It displays the camera output in the screen by default,\nwhen the application is started and enables access/navigation to all features of the application.\n\n\u003cdiv align=\"center\"\u003e\n   \u003cbr/\u003e\n   \u003cimg src=\"Images/SB_Camera.png\" alt=\"Home screen\" width=\"1000\" height=\"600\"\u003e\n   \u003cbr/\u003e\n   \u003cbr/\u003e\n\u003c/div\u003e\n\n### 📷 Shoot\n\nImage(s) can be taken instantly by clicking on Shoot button in home screen.\n\n### ⏯ Record\n\nRecord button in the home screen toggles video recording and it can be used to start and stop recording.\n\n_Image and video files generated will be stored in [Media location](#media-location) as .jpg and .avi respectively._\n\n### 🖌 Effects\n\nThe Effects screen features filters that can be applied to the camera output.\n\n\u003cdiv align=\"center\"\u003e\n   \u003cbr/\u003e\n   \u003cimg src=\"Images/SB_Effects.png\" alt=\"Effects screen\" width=\"1000\" height=\"600\"\u003e\n   \u003cbr/\u003e\n   \u003cbr/\u003e\n\u003c/div\u003e\n\nTo capture images and video by applying filters follow the below steps:\n\n- Enable the checkbox associated with the desired filter(s).\n\n- Navigate to the home screen using \u003c👈 Back to 📷\u003e button, which will now display the camera output\n  post application of the selected filters.\n\n- Use Shoot or Record options in the home screen as explained before.\n\nPlay around with multiple filters to capture some _grooviest_ images and videos.\n\n\u003cdiv align=\"center\"\u003e\n   \u003cbr/\u003e\n   \u003cimg src=\"Images/SB_CamwithEffects.png\" alt=\"Home screen with effects\" width=\"1000\" height=\"600\"\u003e\n   \u003cbr/\u003e\n   \u003cbr/\u003e\n\u003c/div\u003e\n\n### 🖼 Gallery\n\nGallery screen is a file browser which displays list of images and videos captured using the application,\nas shown in the image below.\n\n\u003cdiv align=\"center\"\u003e\n   \u003cbr/\u003e\n   \u003cimg src=\"Images/SB_Gallery.png\" alt=\"Gallery screen\" width=\"1000\" height=\"600\"\u003e\n   \u003cbr/\u003e\n   \u003cbr/\u003e\n\u003c/div\u003e\n\n### 👁 Preview\n\nPreview screen renders the media file that is opened via gallery screen. This screen currently\nsupports display of files only in .jpg format, with more formats to be added in the future versions.\n\n\u003cdiv align=\"center\"\u003e\n   \u003cbr/\u003e\n   \u003cimg src=\"Images/SB_Preview.png\" alt=\"Preview screen\" width=\"1000\" height=\"600\"\u003e\n   \u003cbr/\u003e\n   \u003cbr/\u003e\n\u003c/div\u003e\n\n### 🛑 Quit\n\nThe application can be safely exited using Quit button in home screen.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidy22%2Fskunkbooth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidy22%2Fskunkbooth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidy22%2Fskunkbooth/lists"}