{"id":29022693,"url":"https://github.com/gelso/bigbuttonplay","last_synced_at":"2025-06-26T03:03:25.249Z","repository":{"id":299581428,"uuid":"1003480196","full_name":"gelso/BigButtonPlay","owner":"gelso","description":"BigButtonPlay is a simple, senior-friendly tool to interact with YouTube's API. This is an open-source, non-profit project created to help bridge the digital divide and make technology more accessible to more people.","archived":false,"fork":false,"pushed_at":"2025-06-24T17:08:35.000Z","size":2145,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-24T17:24:55.543Z","etag":null,"topics":["accessibility","assistive-technology","digital-inclusion","elderly","nonprofit","open-source","seniors","simple-ui","user-interface","youtube"],"latest_commit_sha":null,"homepage":"http://bigbuttonplay.com/","language":"HTML","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/gelso.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-06-17T08:01:55.000Z","updated_at":"2025-06-24T17:08:39.000Z","dependencies_parsed_at":"2025-06-17T09:39:45.418Z","dependency_job_id":"eb293db6-f989-4ae0-ab1a-2042dc71931f","html_url":"https://github.com/gelso/BigButtonPlay","commit_stats":null,"previous_names":["gelso/bigbuttonplay"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gelso/BigButtonPlay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gelso%2FBigButtonPlay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gelso%2FBigButtonPlay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gelso%2FBigButtonPlay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gelso%2FBigButtonPlay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gelso","download_url":"https://codeload.github.com/gelso/BigButtonPlay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gelso%2FBigButtonPlay/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261990289,"owners_count":23241186,"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":["accessibility","assistive-technology","digital-inclusion","elderly","nonprofit","open-source","seniors","simple-ui","user-interface","youtube"],"created_at":"2025-06-26T03:03:24.469Z","updated_at":"2025-06-26T03:03:25.218Z","avatar_url":"https://github.com/gelso.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BigButtonPlay\n\n![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)\n![Non-Commercial](https://img.shields.io/badge/Commercial%20Use-Prohibited-red)\n![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red)\n\nA simple, senior-friendly web application to interact with YouTube's API. \n\n**Designed specifically for older adults and users who are not comfortable with technology.** BigButtonPlay features only 2-3 large, clearly visible buttons to make using YouTube as simple as possible.\n\n\u003cp float=\"left\"\u003e\n  \u003cimg src=\"images/screenshot1.png\" width=\"200\"/\u003e\n  \u003cimg src=\"images/screenshot2.png\" width=\"200\"/\u003e\n  \u003cimg src=\"images/screenshot3.png\" width=\"200\"/\u003e\n  \n\u003c/p\u003e\n\nThis is an **open-source, non-profit project** created to help bridge the digital divide and make technology more accessible to more people.\n\n**🌐 Try it now:** [bigbuttonplay.com](https://bigbuttonplay.com)\n\n## 🔧 Important Setup Information\n\n**Before you start:** To use Google's free YouTube API, a one-time technical setup is required. This configuration step needs to be completed by someone with basic technical knowledge (a family member, friend, or tech-savvy person). A Gmail account is needed to obtain a free YouTube API key, which must then be copied into the website's configuration page; your API key is stored only in your browser (never on our servers). Once configured, the tool becomes completely simple to use for everyone.\n\n- 📧 **Requirement:** Gmail account\n- ⏱️ **Time:** 5-10 minutes setup\n- 👥 **Who can help:** Family member or tech-savvy friend (one-time assistance)\n- 💰 **Cost:** Completely free\n\n\n## How to Use\n\n**BigButtonPlay is now available as a web application! No downloads required.**\n\n### Quick Start\n1. **Visit:** [bigbuttonplay.com](https://bigbuttonplay.com) \n2. **Configure:** Set up your YouTube API key (one-time setup, see below)\n3. **Choose:** Select your preferred language\n4. **Enjoy:** Simple YouTube experience with big, clear buttons!\n\n*Note: More languages coming soon! Currently available:\nUN Official Languages - English, Spanish, Chinese, French, Russian, Arabic -\nplus additional major languages: Italian, Hindi, Portuguese and German.*\n\n---\n\n## Setup Instructions\n\nBigButtonPlay requires a **free YouTube API key** for operation. This is a **one-time setup** guided by our interactive wizard that enables the app to search YouTube videos.\n\n\u003e **📹 Video Tutorial Coming Soon!**  \n\u003e We're preparing a step-by-step video guide that walks through this entire setup process. Subscribe to our [YouTube channel @BigButtonPlay](https://www.youtube.com/@BigButtonPlay) to be notified when it's ready!\n\n### Process Overview\n\n#### Quick Start with Setup Wizard\n1. **Visit:** [bigbuttonplay.com](https://bigbuttonplay.com) \n2. **Click:** \"Setup YouTube API Key\" button\n3. **Follow:** The 4-step guided wizard\n4. **Done:** Start using BigButtonPlay immediately!\n\nThe interactive wizard will guide you through these 4 simple steps *(details below)*:\n\n```mermaid\nflowchart TD\n    A[Start BigButtonPlay Setup] --\u003e B[\"Step 1: Create Google Project\"]\n    B --\u003e C[\"Step 2: Enable YouTube API\"]\n    C --\u003e D[\"Step 3: Create API Key\u003cbr/\u003e\u003csmall\u003e+ Add restrictions\u003c/small\u003e\"]\n    D --\u003e E[\"Step 4: Test \u0026 Save\"]\n    E --\u003e F[Setup Complete - Start Using!]\n    \n    style A fill:#e1f5fe\n    style F fill:#c8e6c9\n```\n\n#### Quick Start with Setup Wizard - details\n\n1. **Visit:** [bigbuttonplay.com](https://bigbuttonplay.com) \n2. **Click:** The red \"⚙️ Setup YouTube API Key\" button\n3. **Follow:** The 4-step wizard with visual progress bar\n4. **Important:** Click the red action buttons in each step, complete the task in the new Google tab, then return and click the gray \"Next Step\" button\n5. **Done:** The wizard tests your API key automatically and you're ready to go!\n\n**Wizard Navigation Tips:**\n- 🔴 **Red buttons** = Open Google Cloud Console pages  \n- ⚫ **Gray buttons** = Move to next step in wizard\n- 🟢 **Green button** = Test \u0026 save your API key\n- ✅ **Progress bar** shows exactly where you are\n\n**Stuck?** See the detailed manual process below.\n\n### Manual Setup (Alternative Method)\n\nIf the wizard doesn't work or you prefer manual configuration, follow these detailed steps:\n\n#### Step 1: Create Google Cloud Project\n1. Go to [Google Cloud Console](https://console.cloud.google.com/projectcreate)\n2. Sign in with your Google account\n3. Click \"CREATE PROJECT\"\n4. Project name: \"BigButtonPlay-YourName\" (or any name you prefer)\n5. Click \"CREATE\" and wait for project creation (~30 seconds)\n\n#### Step 2: Enable YouTube Data API v3\n1. Visit [YouTube Data API v3 Library](https://console.cloud.google.com/apis/library/youtube.googleapis.com)\n2. Ensure your project is selected at the top\n3. Click the blue \"ENABLE\" button\n4. Wait for the API to be enabled\n\n#### Step 3: Create and Restrict API Key\n1. Go to [Credentials page](https://console.cloud.google.com/apis/credentials)\n2. Click \"CREATE CREDENTIALS\" → \"API key\"\n3. Copy the generated API key\n4. Click \"RESTRICT KEY\"\n5. Under \"API restrictions\": Select \"Restrict key\" and choose only \"YouTube Data API v3\"\n6. Click \"SAVE\"\n\n\u003e **💡 Pro Tip:** Save this Credentials page link - it's YOUR personal API management area! You can return to your page anytime to:\n\u003e - View your current API keys\n\u003e - Delete old keys if needed  \n\u003e - Create new keys for BigButtonPlay\n\n#### Step 4: Configure BigButtonPlay\n1. Go to [bigbuttonplay.com/config.html](https://bigbuttonplay.com/config.html)\n2. Navigate through the wizard to reach the API key input:\n   - Click \"Let's Get Started\"\n   - Click \"Project Created, Next Step\" \n   - Click \"API Enabled, Next Step\"\n3. Paste your API key in the input field\n4. Click \"Test \u0026 Save API Key\"\n5. Choose your language and start using BigButtonPlay!\n\n---\n\n## Important Notes\n\n- ⚠️ **Setup requirement**: Gmail account needed for the free YouTube API key\n- 🔒 **Privacy**: Your API key stays in your browser only (never on our servers)\n- 💰 **Cost**: Completely free for normal personal use\n- 👨‍👩‍👧‍👦 **Family setup**: One tech-savvy person does setup, everyone enjoys simple interface\n- 📱 **Cross-device:** Works on computers, tablets, and smartphones\n\n---\n\n## Troubleshooting\n- **\"API key not valid\"**: Ensure you copied the key correctly and YouTube Data API v3 is enabled\n- **\"Access denied\"**: Check that your API key restrictions include only YouTube Data API v3\n- **\"Quota exceeded\"**: You've reached the daily limit - try again tomorrow\n\n---\n\n## 📄 License\n\nThis project is licensed under **Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International** (CC BY-NC-SA 4.0).\n\n### 🚫 Non-Commercial License\n\n**You MAY:**\n- ✅ Use BigButtonPlay for personal purposes\n- ✅ Use in educational settings\n- ✅ Use in non-profit organizations  \n- ✅ Modify and improve the code\n- ✅ Share with others (under same license)\n\n**You MAY NOT:**\n- ❌ Use for any commercial purposes\n- ❌ Add advertising or monetization\n- ❌ Sell or license to third parties\n- ❌ Integrate into commercial products\n- ❌ Generate revenue from this software\n\n### Why Non-Commercial?\n\nBigButtonPlay was created specifically to **bridge the digital divide** and make technology accessible to seniors and people with difficulties. It's a **social mission project**, not a commercial product.\n\nSee the [LICENSE](LICENSE) file for complete terms.\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgelso%2Fbigbuttonplay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgelso%2Fbigbuttonplay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgelso%2Fbigbuttonplay/lists"}