Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YTtoFile

YouTube / Shorts / Music → MP3 or MP4

Paste a link. Pick a format. Download.
No shady websites. No ads. Runs on your PC.

Windows PowerShell License: MIT UI GitHub stars

Author: Luckisugar · Repo: Luckisugar/YTtoFile

Features · Install · Usage · Dependencies · PT-BR · Uninstall · Disclaimer


Why this exists

Online “YouTube to MP3” sites are slow, ad-infested, and sketchy.

YTtoFile is a small portable Windows GUI on top of yt-dlp + ffmpeg (+ Deno for modern YouTube extraction).
Downloads stay on your machine. Delete the folder = uninstall.


Features

MP3 / MP4 Audio extract or video download
Quality presets High / medium audio; best / 1080 / 720 / 480 video
Windows-friendly MP4 Prefers H.264 + AAC so Movies & TV actually opens the file
Preflight Checks OS, PowerShell, write access, network, yt-dlp, ffmpeg, Deno
Log dock Side log, collapsed by default — only opens when you press Show Log
EN + PT-BR First-run language picker; saved in ui-language.txt
One-click EXE Double-click YTtoFile.exe — no console, no VBS
Portable Everything under one folder; deps install into vendor\
Clean uninstall Delete the folder. No AppData. No services.

Install

For everyone (dumb-simple) — Release ZIP

  1. Open Releases
  2. Download YTtoFile-vX.Y.Z.zip
  3. Extract the folder anywhere
  4. Double-click YTtoFile.exe

First run:

  1. Pick English or Portugues (Brasil)
  2. If deps are missing, accept Install deps (yt-dlp + ffmpeg + Deno into vendor\ — no admin, ~100MB+)

If Windows says “Windows protected your PC” / SmartScreen

The EXE is unsigned (a real “publisher: your name” stamp costs money — we don’t ship that). That’s normal for free open-source tools.

  1. Click More info
  2. Click Run anyway

Do not need “right-click → Unblock” as a secret step. Run anyway is the normal Windows path for unsigned apps.

Keep the whole folder together (EXE + YTtoFile.ps1 + src\). Don’t move only the .exe.

Optional — developers / git clone

git clone https://github.com/Luckisugar/YTtoFile.git
cd YTtoFile
.\YTtoFile.exe

(or .\run.bat — starts the EXE if present)


Usage

  1. Paste a YouTube / Shorts / Music URL
  2. Choose mp3 or mp4 + quality
  3. (Optional) change Save to folder
  4. Download
  5. Open the log only if you want it: Show Log

Files default to the tool’s output\ folder.

Tools menu

  • Update yt-dlp
  • Install Deno
  • Install / repair all deps
  • Re-check readiness
  • Change language (restart to apply)

Dependencies

Bundled on first install into vendor\ (not committed to git):

Tool Role
yt-dlp Fetches streams
ffmpeg MP3 encode / MP4 merge
Deno JS runtime for YouTube extraction (kills the “no JS runtime” warning)

You need Windows, PowerShell 5.1+, and network for the first dep install and downloads.


Interface language / Idioma

First launch asks for UI language. Preference is stored next to the tool as ui-language.txt (deleted with the folder).

Change later: Tools → Change language… then reopen the app.


Português (Brasil)

YTtoFile baixa videos e audio do YouTube (incluindo Shorts / Music) para MP3 ou MP4, no seu PC, sem site suspeito.

Como instalar (simples)

  1. Abra Releases
  2. Baixe o YTtoFile-vX.Y.Z.zip
  3. Extraia a pasta
  4. Clique duas vezes em YTtoFile.exe

Se o Windows mostrar “O Windows protegeu o seu PC”:

  1. Mais informacoes
  2. Executar assim mesmo

O EXE nao e assinado (assinatura com nome de publisher custa dinheiro). Isso e normal em ferramenta gratis.

  1. Escolha o idioma na primeira abertura
  2. Se pedir, instale as deps em vendor\ (sem admin)
  3. Cole o link → Baixar

O Log fica recolhido por padrao. Use Mostrar Log so se quiser ver o detalhe.

Desinstalar = apagar a pasta.


Uninstall

Delete the project folder.

That removes:

  • the app
  • vendor\ deps
  • output\ downloads (if you left them there)
  • ui-language.txt

Nothing is installed system-wide.


Disclaimer

This tool is for personal / legitimate use. Respect YouTube’s Terms of Service and copyright law in your country.
You are responsible for what you download.

YTtoFile is not affiliated with YouTube or Google.


Credit

Luckisugargithub.com/Luckisugar

Powered by the open-source projects yt-dlp, ffmpeg, and Deno.


License

MIT — free to use, modify, and share. Keep the copyright notice.

About

Portable Windows GUI: YouTube/Shorts/Music to MP3 or MP4 i made so i didn't have to rely on those shady websites cause damn.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages