https://github.com/krishgaur1354/twitch-vods-timestamper
A browser extension that lets you create, manage, and share timestamps from Twitch VODs with ease.
https://github.com/krishgaur1354/twitch-vods-timestamper
timestamps twitch-vods twitchtv
Last synced: 7 months ago
JSON representation
A browser extension that lets you create, manage, and share timestamps from Twitch VODs with ease.
- Host: GitHub
- URL: https://github.com/krishgaur1354/twitch-vods-timestamper
- Owner: KrishGaur1354
- License: mit
- Created: 2025-02-28T17:21:16.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-03-01T08:04:03.000Z (8 months ago)
- Last Synced: 2025-03-01T09:18:18.689Z (8 months ago)
- Topics: timestamps, twitch-vods, twitchtv
- Language: HTML
- Homepage: https://krishgaur1354.github.io/twitch-vods-timestamper/
- Size: 102 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Twitch VOD Timestamper
A browser extension that lets you create, manage, and share timestamps from Twitch VODs with ease.
## 🎮 Features
- **Quick Timestamping**: Create timestamps with a single hotkey while watching VODs
- **Cross-Platform Sharing**: Auto-generate markdown links for Reddit, Discord, or other platforms
- **Export Options**: Export all timestamps to various formats (JSON, TXT, CSV)
- **Advanced Search**: Search through your timestamp collection with regex support
- **Categories & Tags**: Tag and categorize moments (kills, fails, funny moments, etc.)
## 📋 Installation
### From Stores
- Microsoft Edge: Available in the Edge Add-ons store
- Other browsers: Coming later
### Manual Installation (Development)
#### Microsoft Edge
1. Clone this repository: `git clone https://github.com/KrishGaur1354/twitch-vods-timestamper.git`
2. Go to `edge://extensions`
3. Enable "Developer mode"
4. Click "Load unpacked"
5. Select the cloned repository folder
#### Firefox
1. Clone this repository: `git clone https://github.com/KrishGaur1354/twitch-vods-timestamper.git`
2. Go to `about:debugging#/runtime/this-firefox`
3. Click "Load Temporary Add-on..."
4. Navigate to the cloned repository and select `manifest.json`
## 🔧 Usage
### Basic Commands
```bash
# Create a timestamp with description
timestamp add "Amazing play by Shroud" --vod 123456789
# List recent timestamps
timestamp list --recent 3
# Export timestamps
timestamp export --format markdown
```
### Configuration
Create a `.timestamprc` file in your home directory:
```json
{
"defaultFormat": "markdown",
"autoExport": true,
"exportPath": "~/Documents/timestamps/"
}
```
## 📁 Project Structure
```
twitch-stamper/
├── icons/
│ └── ascii-art.png
├── src/
│ ├── background.js
│ ├── content-styles.css
│ ├── content.js
│ └── manifest.json
├── popup-styles.css
├── popup.html
├── popup.js
├── web/
│ ├── index.html
│ └── manifest.json
└── README.md
```
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
## 📞 Contact
- GitHub: [@KrishGaur1354](https://github.com/KrishGaur1354)
## 🙏 Acknowledgments
- Made with ❤️ for the Twitch community
- Inspired by the legacy of Justin.tv