{"id":25385396,"url":"https://github.com/stroller15/timelapse-maker-cli","last_synced_at":"2025-04-09T16:28:42.939Z","repository":{"id":269292554,"uuid":"903025719","full_name":"Stroller15/timelapse-maker-cli","owner":"Stroller15","description":"Timelapse video maker that doesn't consume much storage: it takes snapshots at specified intervals and creates a video.","archived":false,"fork":false,"pushed_at":"2024-12-22T13:22:42.000Z","size":6,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-15T09:48:35.444Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/Stroller15.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":"2024-12-13T19:12:04.000Z","updated_at":"2025-01-30T19:25:18.000Z","dependencies_parsed_at":"2024-12-25T07:49:04.976Z","dependency_job_id":null,"html_url":"https://github.com/Stroller15/timelapse-maker-cli","commit_stats":null,"previous_names":["stroller15/timelapse-maker-cli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stroller15%2Ftimelapse-maker-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stroller15%2Ftimelapse-maker-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stroller15%2Ftimelapse-maker-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stroller15%2Ftimelapse-maker-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Stroller15","download_url":"https://codeload.github.com/Stroller15/timelapse-maker-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248067326,"owners_count":21042276,"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":[],"created_at":"2025-02-15T09:48:39.353Z","updated_at":"2025-04-09T16:28:42.904Z","avatar_url":"https://github.com/Stroller15.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Timelapse Maker CLI\n\n**Timelapse Maker** is a Python-based tool to create stunning camera timelapses. It supports desktop PCs, Raspberry Pis, and MacBooks, providing a simple setup process and flexible customization options.\n\n---\n\n## Requirements\n- Python \u003e= 3.8  \n- Git  \n- macOS or Linux (Windows support is experimental)  \n- [Homebrew](https://brew.sh/) (for macOS users)\n\n---\n\n## Setup\n\n### Step 1: Clone the Repository\n```bash\ngit clone https://github.com/Infatoshi/timelapse-maker\ncd timelapse-maker\npython3 -m venv .venv\nsource .venv/bin/activate\n```\n\n### Step 2: Install Dependencies\n\n#### For Linux\n```bash\nsudo apt install ffmpeg fswebcam\n```\n\n#### For macOS\n```bash\npip install opencv-python numpy\nbrew install ffmpeg\n```\n\n#### For Windows\n1. Open Command Prompt (`Win + R`, then type `cmd`).  \n2. Navigate to the project folder:  \n   ```bash\n   cd C:\\User\\Desktop\\python-projs\\timelapse-maker\n   ```\n3. Activate the virtual environment and install dependencies:  \n   ```bash\n   .venv\\Scripts\\activate.bat\n   pip install opencv-python\n   ```\n\n---\n\n## Usage\n\n### Capture a Timelapse\nRun the following command to capture frames for the timelapse:\n```bash\npython capture_timelapse.py --hours 12 --interval 15\n```\n- `--hours`: Duration of the timelapse capture.  \n- `--interval`: Time (in seconds) between each frame. A shorter interval makes the timelapse smoother.\n\n### Create the Timelapse Video\nAfter capturing frames, convert them into a video:\n```bash\npython create_timelapse.py\n```\n- **Note**: This script uses a custom FFmpeg command and is supported on macOS and Linux.\n\n### Configure the Camera\nIf you have multiple cameras (including virtual ones), adjust the camera index in the script:\n- Default: `device=0`  \n- Increment the value (e.g., `device=1`, `device=2`, etc.) until the correct camera is used.  \n\nCaptured frames are stored in the `timelapse_images` directory for review.\n\n---\n\n## Using `add_clock.py`\n- This script overlays a clock on your timelapse frames.\n- Requires `opencv-python`. Install it manually:\n  ```bash\n  pip install opencv-python\n  ```\n- **Note**: Installation on Raspberry Pi might throw errors. This dependency is excluded from the default setup to ensure smooth installation.\n\n---\n\n## License\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\nFeel free to suggest further improvements or report issues! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstroller15%2Ftimelapse-maker-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstroller15%2Ftimelapse-maker-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstroller15%2Ftimelapse-maker-cli/lists"}