# نصب Flatpak
sudo apt update
sudo apt install -y flatpak
 
# نصب افزونهٔ Flatpak برای GNOME Software (اختیاری اما توصیه‌شده)
sudo apt install -y gnome-software-plugin-flatpak
 
# خروجی نمونه:
# The following NEW packages will be installed:
#   flatpak gnome-software-plugin-flatpak libflatpak0 ...

# افزودن مخزن Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
 
# خروجی: (در صورت موفقیت، بدون پیام)
 
# بررسی مخازن
flatpak remotes
# Name    Options
# flathub system

flatpak update

# جستجوی برنامه
flatpak search spotify
 
# خروجی:
# Description                                  Application          Version
# Spotify                                      com.spotify.Client    1.2.31
# spot                                         dev.alextren.Spot     0.6.0
 
# جستجوی گسترده‌تر
flatpak search code

# نصب برنامه (با تأیید)
flatpak install flathub com.spotify.Client
 
# نصب بدون پرسش تأیید
flatpak install -y flathub com.spotify.Client
 
# نصب نسخهٔ خاص
flatpak install flathub com.spotify.Client//1.2.31

# اجرای برنامه با شناسهٔ کامل
flatpak run com.spotify.Client
 
# اجرای با نام کوتاه (اگر یکتا باشد)
flatpak run spotify

# لیست برنامه‌های نصب‌شده
flatpak list
 
# خروجی:
# Name          Application         Version   Branch Origin  Installation
# Spotify       com.spotify.Client  1.2.31    stable flathub system
# GIMP          org.gimp.GIMP       2.10.36   stable flathub system
 
# لیست فقط برنامه‌ها (بدون runtime)
flatpak list --app
 
# اطلاعات یک برنامه
flatpak info com.spotify.Client
 
# به‌روزرسانی همهٔ برنامه‌ها
flatpak update
 
# به‌روزرسانی یک برنامه
flatpak update com.spotify.Client

# حذف برنامه
flatpak uninstall com.spotify.Client
 
# حذف بدون پرسش
flatpak uninstall -y com.spotify.Client
 
# حذف همهٔ برنامه‌های نصب‌شده
flatpak uninstall --all
 
# حذف runtimeهای غیراستفاده
flatpak uninstall --unused

# نصب ابزار مدیریت permission
sudo apt install -y flatpak
 
# مشاهدهٔ permissionهای یک برنامه
flatpak info --show-permissions com.spotify.Client
 
# افزودن دسترسی به پوشهٔ ~/Music
flatpak override --user --filesystem=~/Music com.spotify.Client
 
# افزودن دسترسی به تمام دستگاه‌های removable
flatpak override --user --filesystem=/media com.spotify.Client
 
# حذف یک permission
flatpak override --user --nofilesystem=~/Music com.spotify.Client
 
# بازنشانی همهٔ permissionها
flatpak override --user --reset com.spotify.Client

# نصب Flatseal
flatpak install flathub com.github.tchx84.Flatseal
 
# اجرای Flatseal
flatpak run com.github.tchx84.Flatseal

# نصب برنامه‌های کاربردی
flatpak install -y flathub org.mozilla.firefox          # Firefox
flatpak install -y flathub org.gimp.GIMP                # GIMP
flatpak install -y flathub org.inkscape.Inkscape        # Inkscape
flatpak install -y flathub org.onlyoffice.desktopeditors # ONLYOFFICE
flatpak install -y flathub org.videolan.VLC             # VLC
flatpak install -y flathub com.spotify.Client           # Spotify
flatpak install -y flathub org.telegram.desktop         # Telegram
flatpak install -y flathub com.discordapp.Discord       # Discord
flatpak install -y flathub com.visualstudio.code        # VS Code

# بررسی فضای اشغال‌شده
flatpak list --app --columns=application,size
 
# پاک‌سازی runtimeهای غیراستفاده
flatpak uninstall --unused
 
# Repair در صورت مشکل
flatpak repair
 
# بررسی به‌روزرسانی‌های موجود
flatpak remote-ls --updates flathub

# افزودن مجدد Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# اجرای با خروجی دیباگ
flatpak run --verbose com.spotify.Client
 
# بررسی لاگ‌ها
journalctl -xe | grep flatpak

flatpak override --user --filesystem=home com.spotify.Client

# پاک‌سازی runtimeهای غیراستفاده
flatpak uninstall --unused
 
# بررسی حجم نصب‌شده
du -sh ~/.local/share/flatpak
sudo du -sh /var/lib/flatpak

# تنظیم mirror برای Flathub (در صورت موجود بودن)
# یا نصب نرم‌افزار دانلودمنیجر مثل aria2