{"id":40603702,"url":"https://github.com/theapache64/lofify","last_synced_at":"2026-01-21T04:37:25.934Z","repository":{"id":290165842,"uuid":"973555906","full_name":"theapache64/lofify","owner":"theapache64","description":"a tiny program that adds randomly selected lofi track  to create perfect ambiance for boring screen recordings ","archived":false,"fork":false,"pushed_at":"2025-11-19T04:27:38.000Z","size":3195,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-19T06:11:40.790Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","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/theapache64.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-27T08:40:26.000Z","updated_at":"2025-11-19T04:27:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"14a0bf0b-6718-4db8-abfc-193794c340d5","html_url":"https://github.com/theapache64/lofify","commit_stats":null,"previous_names":["theapache64/lofify"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/theapache64/lofify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theapache64%2Flofify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theapache64%2Flofify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theapache64%2Flofify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theapache64%2Flofify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theapache64","download_url":"https://codeload.github.com/theapache64/lofify/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theapache64%2Flofify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28626519,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T02:47:06.670Z","status":"ssl_error","status_checked_at":"2026-01-21T02:45:44.886Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-21T04:37:24.883Z","updated_at":"2026-01-21T04:37:25.848Z","avatar_url":"https://github.com/theapache64.png","language":"Shell","readme":"![](cover.jpeg)\n\n# 🎵 Lofify\n\n![buildStatus](https://img.shields.io/github/workflow/status/theapache64/lofify/Java%20CI%20with%20Gradle?style=plastic)\n![latestVersion](https://img.shields.io/github/v/release/theapache64/lofify)\n\u003ca href=\"https://twitter.com/theapache64\" target=\"_blank\"\u003e\n\u003cimg alt=\"Twitter: theapache64\" src=\"https://img.shields.io/twitter/follow/theapache64.svg?style=social\" /\u003e\n\u003c/a\u003e\n\n\u003e A simple shell utility to add lofi background music to your videos.\n\nlofify takes videos, adds randomly selected lofi track from collection, with smooth fade-in and fade-out effects, to create perfect ambiance for boring screen recordings 🤷🏼\n\nhttps://github.com/user-attachments/assets/67b617a2-1832-404e-88e0-23500b5c53a4\n\n## Features\n\n- 🎲 Randomly selects lofi background tracks\n- 🎚️ Option to overlay or completely replace original audio\n- 🔊 Smart fade-in and fade-out effects\n- ⏱️ Automatically trims audio to match video length\n- 🎯 Random starting point selection for variety\n- 📦 Optional video compression (slow or fast modes) to reduce file size\n\n## Usage\n\n### Basic Usage\n\nAdd lofi background music to your video (overlaying with original audio):\n\n```bash\nlofify /path/to/your/video.mp4\n```\n\n### Replace Original Audio\n\nTo completely replace the original audio with lofi music:\n\n```bash\nlofify /path/to/your/video.mp4 -r\n```\n\n### Compress Video\n\nTo compress the video while adding lofi music, you have two options:\n\n**Slow compression** (best compression, slower processing):\n```bash\nlofify /path/to/your/video.mp4 -c\n```\n\n**Fast compression** (good compression, faster processing):\n```bash\nlofify /path/to/your/video.mp4 -cf\n```\n\nYou can also combine compression with other flags:\n\n```bash\n# Slow compression + replace audio\nlofify /path/to/your/video.mp4 -c -r\n\n# Fast compression + replace audio\nlofify /path/to/your/video.mp4 -cf -r\n```\n\n**Note**:\n- `-c` uses H.264 codec with CRF 28 and slow preset for optimal file size reduction\n- `-cf` uses H.264 codec with CRF 28 and superfast preset for faster encoding\n- Both compression modes take longer than the default mode which simply copies the video stream\n- You cannot use both `-c` and `-cf` flags together\n\n### Output\n\nThe processed video will be saved as `[original_name]_lofi.mp4` in the same directory as the original video.\n\n\n## Prerequisites\n\nBefore installing Lofify, make sure you have the following dependencies:\n\n- **ffmpeg**: Required for audio/video processing\n  - macOS: `brew install ffmpeg`\n  - Ubuntu/Debian: `sudo apt install ffmpeg`\n  - Other systems: Visit [ffmpeg.org/download.html](https://ffmpeg.org/download.html)\n\n- **bc**: Required for floating-point calculations\n  - macOS: `brew install bc`\n  - Ubuntu/Debian: `sudo apt install bc`\n\n## Quick Installation\n\nInstall Lofify with a single command:\n\n```bash\ncurl -s https://raw.githubusercontent.com/theapache64/lofify/master/install.sh | bash\n```\n\nor\n\n```bash\nwget -qO- https://raw.githubusercontent.com/theapache64/lofify/master/install.sh | bash\n```\n\nThis will:\n- Install the Lofify script to your `~/bin` directory\n- Set up sample lofi audio files in `~/lofi_audios`\n- Add `~/bin` to your PATH (if not already there)\n\nAfter installation, you may need to restart your terminal or run `source ~/.bashrc` or `source ~/.zshrc` to make the command available in your current session.\n\n## Manual Installation\n\nIf you prefer manual installation:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/theapache64/lofify.git\n   ```\n\n2. Make the script executable:\n   ```bash\n   chmod +x lofify.sh\n   ```\n\n3. Move the script to a directory in your PATH:\n   ```bash\n   mkdir -p ~/bin\n   cp lofify.sh ~/bin/lofify\n   ```\n\n4. Create a directory for lofi audio files:\n   ```bash\n   mkdir -p ~/lofi_audios\n   ```\n\n5. Copy the sample lofi audio files:\n   ```bash\n   cp -r lofi_audios/* ~/lofi_audios/\n   ```\n\n6. Add `~/bin` to your PATH (if not already there):\n   ```bash\n   echo 'export PATH=\"$HOME/bin:$PATH\"' \u003e\u003e ~/.bashrc  # or ~/.zshrc\n   source ~/.bashrc  # or source ~/.zshrc\n   ```\n\n\n## Adding Your Own Lofi Tracks\n\nTo add your own lofi tracks:\n\n1. Place your audio files (MP3, WAV, or OGG format) in the `~/lofi_audios` directory:\n   ```bash\n   cp your_lofi_track.mp3 ~/lofi_audios/\n   ```\n\n2. That's it! Lofify will now include your tracks in the random selection.\n\n## Examples\n\n### Add lofi background to a screen recording:\n\n```bash\nlofify ~/Desktop/screen_recording.mp4\n```\n\n### Replace audio in a tutorial video:\n\n```bash\nlofify ~/Videos/tutorial.mp4 -r\n```\n\n### Compress a large video while adding lofi music (slow, best compression):\n\n```bash\nlofify ~/Desktop/large_video.mp4 -c\n```\n\n### Fast compress a video for quick sharing:\n\n```bash\nlofify ~/Desktop/demo_video.mp4 -cf\n```\n\n### Compress and replace audio (combine both flags):\n\n```bash\n# Slow compression\nlofify ~/Videos/presentation.mp4 -c -r\n\n# Fast compression\nlofify ~/Videos/presentation.mp4 -cf -r\n```\n\n### Author\n\n👤 **theapache64**\n\n* Twitter: \u003ca href=\"https://twitter.com/theapache64\" target=\"_blank\"\u003e@theapache64\u003c/a\u003e\n* Email: theapache64@gmail.com\n\nFeel free to ping me 😉\n\n### Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any\ncontributions you make are **greatly appreciated**.\n\n1. Open an issue first to discuss what you would like to change.\n1. Fork the Project\n1. Create your feature branch (`git checkout -b feature/amazing-feature`)\n1. Commit your changes (`git commit -m 'Add some amazing feature'`)\n1. Push to the branch (`git push origin feature/amazing-feature`)\n1. Open a pull request\n\nPlease make sure to update tests as appropriate.\n\n## ❤ Show your support\n\nGive a ⭐️ if this project helped you!\n\n\u003ca href=\"https://www.patreon.com/theapache64\"\u003e\n  \u003cimg alt=\"Patron Link\" src=\"https://c5.patreon.com/external/logo/become_a_patron_button@2x.png\" width=\"160\"/\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.buymeacoffee.com/theapache64\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" width=\"160\"\u003e\n\u003c/a\u003e\n\n\n\n## License\n\n```\nCopyright © 2025 - theapache64\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n\n_This README was generated by [readgen](https://github.com/theapache64/readgen)_ ❤\n","funding_links":["https://www.patreon.com/theapache64","https://www.buymeacoffee.com/theapache64"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheapache64%2Flofify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheapache64%2Flofify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheapache64%2Flofify/lists"}