{"id":15706581,"url":"https://github.com/tinchodias/youtube-marks","last_synced_at":"2025-05-12T19:02:13.866Z","repository":{"id":41587312,"uuid":"296459920","full_name":"tinchodias/youtube-marks","owner":"tinchodias","description":"Annotate YouTube videos with this simple tool","archived":false,"fork":false,"pushed_at":"2023-03-05T13:48:34.000Z","size":681,"stargazers_count":6,"open_issues_count":10,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-01T01:51:11.215Z","etag":null,"topics":["mark","video","youtube"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tinchodias.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}},"created_at":"2020-09-17T22:57:05.000Z","updated_at":"2024-05-31T12:37:04.000Z","dependencies_parsed_at":"2024-10-24T07:43:04.205Z","dependency_job_id":"00c12010-7aa9-49ac-989c-cff5a8cc921b","html_url":"https://github.com/tinchodias/youtube-marks","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinchodias%2Fyoutube-marks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinchodias%2Fyoutube-marks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinchodias%2Fyoutube-marks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinchodias%2Fyoutube-marks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tinchodias","download_url":"https://codeload.github.com/tinchodias/youtube-marks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253805850,"owners_count":21967052,"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":["mark","video","youtube"],"created_at":"2024-10-03T20:24:37.133Z","updated_at":"2025-05-12T19:02:13.825Z","avatar_url":"https://github.com/tinchodias.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YouTube Marks\n\nAnnotate your videos with this simple tool.\n\n![Screenshot](shot_800.png)\n\n## Intro\n\nThe scenario for this tool is a user that needs to analyze videos.\nThis tool can help by supporting this use case:\n1. Register one or more **videos** in the **project** page. Note the videos must be previously loaded in Youtube. For example, if the video URL is \"`https://youtu.be/_7jUA-Gqp4M`\", the ID to register is \"`_7jUA-Gqp4M`\". \n2. Register one or more **tags** which are kinds of marks to are forseen to be added in the videos (it is enough to register just one, for example, a \"default\" tag). The tags can have an associated **Key binding** which must be a single letter (case-sensitive) to ease insertion during playback. Tags can also have a distinctive color.\n3. Click on a video and control the playback by pressing play, pause (the space key is a key binding for toggling), moving the dot in the bar, or use the top-right button bar for high-precision seek.\n4. To mark the video, there are two main possibilities:\n   - via the \"Add mark\" dropdown, and \n   - via using the key binding of a tag previously defined.\n5. To add a textual comment, click on the pencil button that's present on each row, and edit it (press the small accept button to save the changes).\n\n#### Why YouTube?\nThe tool could become independent of YouTube, or at least be just an option. Maybe in the future. In our experience, it was quite practical like this. We had 16 HD videos of more than an 1 hour long; we uploaded them all one night and the day after the URLs were ready to be added to this tool.\n\n*Tip*: If you upload a video to YouTube, you have to choose a **visibility** mode. In our experience, the more adequate was the **Unlisted** visibility. It differs from the **Public** visibility in that nobody will find them with a YouTube search, and differs from **Private** visibility in that anybody with the video URL can view it.\n\n#### Export/Import\nIt may be convenient for the user to export the marks on a video. This can be done to: \n  - CSV, and edit the marks in a spreadsheets office tool, or \n  - JSON, and edit the marks in a text editor or programatically by any language.\n  \nThose files can be imported back into the project.\n\n#### Persistance/Versioning\nThe whole project (videos, tags, and marks) is read and written in a `json` file. By default, it's `db.json` at the root of this repository. \n\nIn fact, the user might manually edit this file and (re)start the server with `ctrl+c + npm start` to browse the new state.\n\nIt is convenient to regularly version the `json` file to some git repository to keep track of your work.\n\n#### Custom configuration\n\nThere are some customizable parameters for the HTTP server. To do it, you must create a `.env` file at the root of this repository. Example:\n```\nDB_PATH=\"../myDb.json\"\nSERVER_PORT=3000\n```\n\n---\n\n## How to Install\n\n1. Ensure you have [nodejs](https://nodejs.org/).\n2. Clone this repository.\n3. Open a terminal, change directory to root (where this README file is) and run `npm install`.\n\n## How to Launch\n\n1. Open a terminal, change directory to root, and run `npm start`.\n2. Open browser on http://localhost:8080.\n\n\n## License\n\nThis code is licensed under the [MIT license](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinchodias%2Fyoutube-marks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftinchodias%2Fyoutube-marks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinchodias%2Fyoutube-marks/lists"}