Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fritzthecat9/youtubelinks

YoutubeLinks allow users to save YouTube links as playlists. Users are able to download mp3/mp4 files from the playlists they create. Project created as part of the "100 Commits" competition.
https://github.com/fritzthecat9/youtubelinks

api blazor blazor-webassembly c-sharp c-sharp-12 cqrs csharp dot-net-8 dotnet entity-framework-core fluent-validation jwt mediatr minimal-api mudblazor serilog vertical-slice-architecture vue youtube yt-dlp

Last synced: about 2 months ago
JSON representation

YoutubeLinks allow users to save YouTube links as playlists. Users are able to download mp3/mp4 files from the playlists they create. Project created as part of the "100 Commits" competition.

Host: GitHub
URL: https://github.com/fritzthecat9/youtubelinks
Owner: FritzTheCat9
Created: 2024-02-28T00:24:50.000Z (11 months ago)
Default Branch: main
Last Pushed: 2024-10-29T23:37:23.000Z (3 months ago)
Last Synced: 2024-10-29T23:47:05.681Z (3 months ago)
Topics: api, blazor, blazor-webassembly, c-sharp, c-sharp-12, cqrs, csharp, dot-net-8, dotnet, entity-framework-core, fluent-validation, jwt, mediatr, minimal-api, mudblazor, serilog, vertical-slice-architecture, vue, youtube, yt-dlp
Language: C#
Homepage:
Size: 60.4 MB
Stars: 28
Watchers: 1
Forks: 2
Open Issues: 10
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        # YoutubeLinks

I achieved 8th place in the "100 Commits" competition organized by DevMentors. Over 100 days, I developed the 

"YoutubeLinks" application, which allows users to create playlists from YouTube links and download those playlists as

MP3

and MP4 files.

Downloading playlists as MP3 and MP4 files, tested successfully on over 3000 links.

## Youtube video presentation:

[![Youtube Video](https://img.youtube.com/vi/G1gY-jynpu0/0.jpg)](https://www.youtube.com/watch?v=G1gY-jynpu0)

Max downloaded mp3 file: length - 03:31:45, size - 391 MB\

Max downloaded mp4 file: length - 25:44, size - 973 MB\

Larger files not tested or can not work correctly.

## Table of contents

* [Youtube video](#youtube-video-presentation)

* [Launch](#launch)

* [Presentation](#presentation)

* [Technologies](#technologies)

* [Architecture](#architecture)

* [Project types and references](#project-types-and-references)

* [Packages](#packages)

* [Features](#features)

* [Roles](#roles)

* [Project status](#project-status)

## Launch

Run application with one command (setup all docker containers, create database, apply migrations):

```

cd C:\Users\bartl\source\repos\YoutubeLinks

docker compose up --build -d

```

Created containers:

- C# Web API backend:

```

http://localhost:5000

```

- Blazor WASM frontend:

```

http://localhost:7000

```

- MSSQL database:

```

Host: localhost 

Port: 1433 

Database/Schema: YoutubeLinks

Username: sa

Password: Password1!

Server: youtubelinks.database

```

- Seq Api logs:

```

http://localhost:8081

```

Login credentials:

```

Admin:

- Email: [email protected]

- Password: Asd123!

User:

- Email: [email protected]

- Password: Asd123!

```

If You have any problems check issue below or ask me in GitHub issues:

https://github.com/FritzTheCat9/YoutubeLinks/issues/52

## Presentation

Users view:

![Users image](./images/1_users.png)

Playlists view:

![Playlists image](./images/2_playlists.png)

Links view:

![Links image](./images/3_links.png)

Links grid view:

![Links grid image](./images/5_links_grid_view.png)

Download playlist view:

![Download playlists image](./images/4_playlist_downloading.png)

## Technologies

- C# 12

- .NET 9.0

- Blazor WebAssembly

- Vue 3.4.21

## Architecture

Blazor WebAssembly frontend with .NET Minimal API backend connecting to the MSSQL database. Monolithic architecture with

Vertical Slices. Code separated by feature.

## Project types and references

- YoutubeLinks.Api - ASP .NET Core Web API (Backend)

- YoutubeLinks.Blazor - Blazor WebAssembly Standalone App (Frontend)

- YoutubeLinks.Shared - Class Library (Backend and Frontend shared code)

- YoutubeLinks.UnitTests - xUnit Test Project (Unit Tests)

- YoutubeLinks.E2E - NUnit Test Project (E2E Tests)

- youtube-links - Vue Project (Frontend 2)

## Packages

Nuget packages and libraries used in projects.

- Api

    - [EntityFrameworkCore](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer) - ORM for connecting

      to the database

    - [MediatR](https://www.nuget.org/packages/MediatR/) - CQRS, Vertical Slices (code separated by Features)

    - [FluentValidation](https://www.nuget.org/packages/FluentValidation) - Commands, Queries and server side logic

      validation

    - [FluentEmail](https://www.nuget.org/packages/FluentEmail.Razor) - Sending registration confirmation email and

      registration succeeded email

    - [Serilog](https://www.nuget.org/packages/Serilog/3.1.2-dev-02097) - Logging to console and file

    - [JwtBearer](https://www.nuget.org/packages/Microsoft.AspNetCore.Authentication.JwtBearer) - Jwt Token

      Authentication

    - [Swagger](https://www.nuget.org/packages/Swashbuckle.AspNetCore) - Manual Api testing

    - [YoutubeDLSharp](https://github.com/Bluegrams/YoutubeDLSharp) - Get YouTube videos titles, download videos as .mp3

      and .mp4 files

- Blazor

    - [MudBlazor](https://www.nuget.org/packages/MudBlazor) - Blazor UI library

    - [Blazored.FluentValidation](https://www.nuget.org/packages/Blazored.FluentValidation) - Frontend validation +

      Backend validation

    - [Blazored.LocalStorage](https://www.nuget.org/packages/Blazored.LocalStorage) - store Jwt Token in local storage

## Features

- Users

    - Register new user and send confirmation email

    - Resend confirmation email

    - Confirm user registration and send registration success email

    - Login user if email is confirmed

    - Refresh Jwt Token

    - Forgot password

    - Update user color theme

    - Get all users (paginated, sorted and filtered)

    - Get selected user

- Playlist

    - Create playlist

    - Delete playlist

    - Update playlist (set playlist as public / private)

    - Export playlist (.json, .txt)

    - Import playlist (.json, .txt)

    - Download playlist (only undownloaded links)

    - Mark all playlist links as downloaded / undownloaded

    - Get all public playlists (paginated, sorted and filtered)

    - Get all user playlists (paginated, sorted and filtered)

    - Get selected playlist

- Link

    - Create link

    - Delete link

    - Update link (mark as downloaded, change title)

    - Set link downloaded flag

    - Download link (.mp3, .mp4)

    - Download single link (no need to add link to the playlist)

    - Get all playlist links (paginated, sorted and filtered)

    - Get selected link

    - Links grid / table view

## Roles

- Admin - ony one user have Admin role

- User - can view website data, can do CRUD operations on owned playlists and links

- Anonymous - can view website data (public playlists / links)

## Project status

Project created as part of the "[100 Commits](https://100commitow.pl)" competition. The challenge is to add changes to

the repository every day for 100 days.

![100 Commits results image](./images/100commitow_results.jpeg)

I achieved 8th place in the "[100 Commits](https://100commitow.pl)" competition organized

by "[DevMentors.io](https://devmentors.io)". Over 100 days, I developed the "YoutubeLinks" application, which allows

users to create playlists from YouTube links and download those playlists as MP3 and MP4 files.

![100 Commits results photo image](./images/100commitow_results_photo.jpeg)

This project was a significant adventure that taught me perseverance and systematic work to achieve my project goals

within the given timeframe. The "[100 Commits](https://100commitow.pl)" gala was a fantastic event, well-organized with

engaging talks. I look forward to a potential second edition of the competition in the future.