{"id":29599366,"url":"https://github.com/suragms/screen-time-tracker-app","last_synced_at":"2025-07-20T11:06:21.049Z","repository":{"id":300520098,"uuid":"1006374778","full_name":"suragms/Screen-Time-Tracker-App","owner":"suragms","description":"A full-stack productivity and wellness tracker that logs screen time, manages tasks, and visualizes digital habits.","archived":false,"fork":false,"pushed_at":"2025-07-13T16:19:44.000Z","size":23920,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-13T17:40:54.009Z","etag":null,"topics":["analytics","api","digital-detox","django","fullstack","productivity","screen-time","time-management","tracker","wellness"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/suragms.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}},"created_at":"2025-06-22T05:52:51.000Z","updated_at":"2025-07-13T16:19:47.000Z","dependencies_parsed_at":"2025-06-22T07:31:31.395Z","dependency_job_id":null,"html_url":"https://github.com/suragms/Screen-Time-Tracker-App","commit_stats":null,"previous_names":["suragms/screen-time-tracker-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/suragms/Screen-Time-Tracker-App","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suragms%2FScreen-Time-Tracker-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suragms%2FScreen-Time-Tracker-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suragms%2FScreen-Time-Tracker-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suragms%2FScreen-Time-Tracker-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/suragms","download_url":"https://codeload.github.com/suragms/Screen-Time-Tracker-App/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suragms%2FScreen-Time-Tracker-App/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266112314,"owners_count":23878022,"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":["analytics","api","digital-detox","django","fullstack","productivity","screen-time","time-management","tracker","wellness"],"created_at":"2025-07-20T11:06:20.568Z","updated_at":"2025-07-20T11:06:21.040Z","avatar_url":"https://github.com/suragms.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 𝖲𝖢𝖱𝖤𝖤𝖭𝖳𝖨𝖬𝖤 𝖳𝖱𝖠𝖢𝖪𝖤𝖱 𝖠𝖯𝖯\n\n**👨‍💼 CEO**: Surag M S\n**📧 Email**: [suraagms@gmail.com](mailto:suraagms@gmail.com)\n**🔗 GitHub**: [@suragms](https://github.com/suragms)\n**🔗 LinkedIn**: [Surag Sunil](https://linkedin.com/in/suragsunil)\n\n---\n\nA **full-stack productivity and wellness application** designed to **track, manage, and analyze digital habits**. Ideal for developers, students, and digital professionals, it encourages **mindful technology usage** through insightful analytics, integrated tools, and a seamless user experience.\n\n---\n\n## 📌 Table of Contents\n\n* [📖 About the Project](#-about-the-project)\n* [🚀 Key Features](#-key-features)\n* [🛠 Tech Stack](#-tech-stack)\n* [📁 Project Structure](#-project-structure)\n* [⚙️ Installation](#-installation)\n* [📋 Usage](#-usage)\n* [🔗 API Endpoints](#-api-endpoints)\n* [🤝 Contributing](#-contributing)\n* [📝 License](#-license)\n* [📞 Contact](#-contact)\n\n---\n\n## 📖 About the Project\n\nThe **Screen Time Tracker App** is a comprehensive platform built with **Django** and **REST APIs** that allows users to:\n\n* Log and track daily screen time\n* Visualize digital habits and trends\n* Set personal usage goals\n* Manage productivity boosters such as alarms, sticky notes, and an in-app music player\n\nIts modular architecture ensures scalability and customization for future enhancements.\n\n---\n\n## 🚀 Key Features\n\n* ⏱ **Screen Time Logging** – Real-time tracking of daily activities\n* 🧭 **Multiple Concurrent Timers** – Switch between tasks seamlessly\n* 📈 **Analytics Dashboard** – Interactive charts for weekly/monthly trends\n* ⏰ **Custom Alarms** – Set reminders to optimize productivity\n* 📝 **Sticky Notes** – With color-coded tags for better organization\n* 🎧 **Built-in Music Player** – Upload and play focus-enhancing tracks\n* 👤 **Profile Customization** – Personalized user experience\n* 🎯 **Daily Usage Goals** – Set, track, and achieve your screen time goals\n\n---\n\n## 🛠 Tech Stack\n\n| Layer        | Technologies                              |\n| ------------ | ----------------------------------------- |\n| **Frontend** | HTML5, CSS3, Bootstrap, JavaScript        |\n| **Backend**  | Python, Django, Django REST Framework     |\n| **Database** | SQLite3                                   |\n| **Auth**     | Django Authentication System              |\n| **Others**   | JSON, Django Signals, File Upload Support |\n\n---\n\n## 📁 Project Structure\n\n```\nscreen_time_project/\n├── manage.py\n├── requirements.txt\n├── README.md\n├── screentime_project/\n│   ├── __init__.py\n│   ├── settings.py\n│   ├── urls.py\n│   └── wsgi.py\n├── tracker/\n│   ├── __init__.py\n│   ├── admin.py\n│   ├── admin_views.py\n│   ├── apps.py\n│   ├── forms.py\n│   ├── models.py\n│   ├── serializers.py\n│   ├── views.py\n│   ├── urls.py\n│   ├── tests.py\n│   ├── static/\n│   └── templates/\n│       ├── base.html\n│       ├── dashboard.html\n│       └── ...\n│   ├── management/\n│   │   └── commands/\n│   │       └── custom_command.py\n│   └── migrations/\n│       └── 0001_initial.py\n```\n\n---\n\n## ⚙️ Installation\n\n### Prerequisites\n\n* Python 3.8+\n* pip\n* Virtualenv (recommended)\n* Git\n\n### Setup Steps\n\n```bash\n# Clone the repository\ngit clone https://github.com/suragms/screen-time-tracker.git\ncd screen-time-tracker\n\n# Create and activate virtual environment\npython -m venv venv\nvenv\\Scripts\\activate         # On macOS/Linux: source venv/bin/activate\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run database migrations\npython manage.py makemigrations\npython manage.py migrate\n\n# Create an admin user (optional)\npython manage.py createsuperuser\n\n# Start the development server\npython manage.py runserver\n```\n\nAccess the app at: `http://127.0.0.1:8000`\n\n---\n\n## 📋 Usage\n\n### Workflow Overview\n\n1. 🔐 Register or Log in\n2. 👤 Set up your profile\n3. ⏱ Track screen time with start/stop buttons\n4. 📊 Analyze digital habits through the dashboard\n5. ⏰ Set alarms or 📝 create sticky notes\n6. 🎵 Upload and listen to music\n7. 🎯 Monitor and achieve personal usage goals\n\n---\n\n## 🔗 API Endpoints\n\n**Base URL**: `http://localhost:8000/api/`\n\n### Screen Time\n\n| Method | Endpoint            | Description             |\n| ------ | ------------------- | ----------------------- |\n| GET    | `/screentime/`      | Retrieve all entries    |\n| POST   | `/screentime/`      | Create new entry        |\n| GET    | `/screentime/\u003cid\u003e/` | Retrieve specific entry |\n| PUT    | `/screentime/\u003cid\u003e/` | Update entry            |\n| DELETE | `/screentime/\u003cid\u003e/` | Delete entry            |\n\n#### Example Request Payload\n\n```json\n{\n  \"activity\": \"Reading Docs\",\n  \"category\": \"Study\",\n  \"start_time\": \"2025-06-22T10:00:00Z\",\n  \"end_time\": \"2025-06-22T11:00:00Z\",\n  \"notes\": \"Reading Django Docs\"\n}\n```\n\n---\n\n## 🤝 Contributing\n\nWe welcome community contributions!\nTo contribute:\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/your-feature-name`\n3. Commit changes: `git commit -m \"Add your feature\"`\n4. Push to GitHub: `git push origin feature/your-feature-name`\n5. Submit a Pull Request\n\nPlease follow PEP8 coding standards and include tests where appropriate.\n\n---\n\n## 📝 License\n\nThis project is licensed under the **MIT License**.\nSee the full license [here](LICENSE).\n\n---\n\n## 📞 Contact\n\n**Surag M S**\n📧 [suraagms@gmail.com](mailto:suraagms@gmail.com)\n🔗 [GitHub: @suragms](https://github.com/suragms)\n🔗 [LinkedIn: Surag Sunil](https://linkedin.com/in/suragsunil)\n🔗 [Linktree: SuragDevStudio](https://linktr.ee/suragdevstudio)\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuragms%2Fscreen-time-tracker-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuragms%2Fscreen-time-tracker-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuragms%2Fscreen-time-tracker-app/lists"}