KullanımUsage

Kurulum, eklentinin yüklenmesi, indirme akışları, ayarlar ve sorun giderme. Her adım uygulamanın gerçek davranışını anlatır; arayüz dili Türkçedir. Installation, loading the extension, download flows, settings and troubleshooting. Every step describes what the application actually does; the application interface is Turkish.

GereksinimlerRequirements

  • Windows 10 veya Windows 11, 64 bit. Ürün ve doğrulama kapsamındaki tek tarayıcı Chrome'dur. Windows 10 or Windows 11, 64 bit. Chrome is the only browser in the product and validation scope.
  • Uygulama ve eklenti birlikte güncellenmelidir: eklenti, kendi sürümüyle uyuşmayan bir masaüstü uygulamasıyla çalışmayı reddeder. Güncellemeden sonra açık medya sayfalarını yenileyin. Application and extension must be updated together: the extension refuses a desktop application that does not match its own version. Reload open media pages after updating.
  • Medya indirmeleri için gereken bileşenler uygulamayla birlikte gelmez ve kurulum sırasında kurulmaz; uygulamanın kendi Medya araçları penceresinden, siz istediğinizde kurulur. The components media downloads need are not bundled with the application and are not installed during setup; you install them from the application's own Medya araçları (Media tools) window.
  • Aktarım çalışma alanı, indirme klasörünün altındaki .ssdownload-work ağacıdır ve birkaç gigabayta çıkabilir. The transfer work area is the .ssdownload-work tree under the download folder and can reach several gigabytes.
  • Uygulama verileri varsayılan olarak %LOCALAPPDATA%\SSDownload altında tutulur. Application data is kept under %LOCALAPPDATA%\SSDownload by default.

KurulumInstallation

  1. Kasıtlı bir yükseltmeden önce uygulamayı tepsi menüsünden kapatın, sonra Setup'ı çalıştırın. Before an intentional upgrade, exit the application from its tray menu, then run Setup.
  2. Taşınabilir kullanım için ZIP'i kalıcı bir klasöre açın ve ssdownload.exe dosyasını açın. For portable use, extract the ZIP to a permanent folder and open ssdownload.exe.
  3. Kurulumu tarayıcı bağlantısı için kaydedin: masaüstü uygulamasındaki tarayıcı bağlantısı eylemi ya da taşınabilir kullanımda yanındaki register-native-host.cmd. Yürütülebilir dosyayı taşırsanız yeni konumundan yeniden kaydetmeniz gerekir. Register the installation for the browser connection: the browser-connection action in the desktop application, or the adjacent register-native-host.cmd for portable use. Moving the executable requires registering it again from its new location.

Ayrı profilSeparate profile

--data-dir <klasör> ayrı bir profil seçer; SSDOWNLOAD_HOME ortam değişkeni aynı varsayılanı belirler. Başlangıç ve yerel ana makine kaydı bu profil seçimini korur ve tarayıcı bağlantısını en son açıkça kaydedilen kurulum sahiplenir. --data-dir <folder> selects a separate profile; the SSDOWNLOAD_HOME environment variable sets the same default. Startup and native-host registration preserve that choice, and the last explicitly registered installation owns the browser connection.

İkinci bir başlatma yeni bir örnek açmaz: çalışan örneğe devreder ve penceresini öne getirir. A second launch does not start another instance: it hands over to the running one and raises its window.

Tarayıcı eklentisiBrowser extension

Eklenti, uygulamanın yanında gelen paketlenmemiş kopyadan yüklenir. chrome://extensions sayfasını açın, Geliştirici modu'nu etkinleştirin, Paketlenmemiş öğe yükle ile browser/chromium klasörünü seçin. The extension is loaded from the unpacked copy shipped beside the application. Open chrome://extensions, enable Developer mode and choose Load unpacked for the browser/chromium folder.

Yönetilen cihazlarManaged devices

Etki alanına katılmış veya Chrome Enterprise Core'a kayıtlı bir cihazda Genel sekmesindeki Eklentiyi tarayıcılara kur... eylemi ya da ssdownload-cli.exe --install-extension, kullanıcı başına ExtensionInstallForcelist ilkesini yazar. İlkenin uygulanması için Chrome tamamen kapatılıp yeniden açılmalıdır. Yönetilmeyen bir cihazda uygulama bu yazmayı atlar, nedenini bildirir ve paketlenmemiş kopyaya geri yönlendirir. On a device that is domain-joined or enrolled in Chrome Enterprise Core, the Eklentiyi tarayıcılara kur... action on the General tab or ssdownload-cli.exe --install-extension writes the per-user ExtensionInstallForcelist policy. Chrome must be fully closed and reopened for that policy to apply. On a device that is not managed, the application skips that write, reports why and points back at the unpacked copy.

  • Araç çubuğu simgesi eklentinin tüm arayüzüdür: tek tık algılamayı açar veya kapatır, pencere ya da seçenek sayfası açmaz ve ON (yeşil) veya OFF (gri) durumunu gösterir. Kapatmak, sayfanın medya girdilerini hemen geri çeker. The toolbar icon is the whole interface of the extension: one click switches discovery on or off, it opens no popup or options page, and it shows ON (green) or OFF (grey). Switching off withdraws the page's media entries at once.
  • Eklenti sabit bir anahtar kullanır, bu yüzden kimliği değişmez; uygulama güncellemelerinden sonra chrome://extensions sayfasındaki Yenile yeterlidir. The extension uses a fixed key, so its identity is stable; after an application update a Reload on chrome://extensions is enough.

Medya araçlarıMedia tools

Eksik bileşenleri uygulamanın kendi penceresinden kurun: Araçlar → "Medya araçları..." penceresi hangi bileşenlerin eksik olduğunu listeler ve Eksikleri kur düğmesini sunar. Bileşenler kurulmadan başlatılan bir medya işi SSD-TOL-001 ile sizi bu pencereye yönlendirir. Kurulu ve doğrulanmış bileşenler korunur. Install missing components from the application's own window: Araçlar → "Medya araçları..." (Tools → "Media tools...") lists which components are missing and offers the Eksikleri kur (install missing) button. A media job started before they are installed sends you to that window with SSD-TOL-001. Components that are already installed and verified are preserved.

Bileşenler HTTPS üzerinden indirilir, sağlama toplamlarıyla doğrulanır ve tek adımda devreye alınır; kullanımdaki dosyalar değiştirilmeye karşı kilitli tutulur. Aynı işi konsoldan yapmak için ssdownload-cli.exe --install-tools, güncellemek için --update-tools kullanılır. Components are downloaded over HTTPS, verified against their checksums and activated in one step; the files in use stay locked against replacement. From a console the same work is done with ssdownload-cli.exe --install-tools, and --update-tools updates them.

İndirme akışlarıDownload flows

Medya ve oynatıcıMedia and players

  1. Medyayı oynatın ve beliren indirme kaplamasını kullanın. Play the media and use the download overlay it shows.
  2. Kaplama, gözlenen adayı masaüstü uygulamasına devreder; uygulama o kaynak için kendi seçicisini açar: düzenlenebilir bir Ad alanı, dosya biçimi, çözünürlük, kare hızı ve HDR taşıyan kalite listesi, süre satırı ve tek bir İndir eylemi. The overlay hands the observed candidate to the desktop application, which opens its own picker for that source: one editable Ad (title) field, the quality list carrying file format, resolution, frame rate and HDR, the duration line and a single İndir (download) action.
  3. Gelişmiş seçenekler aynı ekranı korur ve kaynak yenilemeyi, ses ile altyazı parçalarını ve aktarım ayarlarını ekler. Gelişmiş seçenekler (advanced options) keeps the full screen and adds source renewal, audio and subtitle tracks and the transfer knobs.
  4. Analizde kanıt yoksa seçici değer uydurmaz: FPS bilinmiyor veya Süre bilinmiyor yazar. Where the analysis has no evidence, the picker invents nothing: it says FPS bilinmiyor or Süre bilinmiyor (the frame rate or duration is unknown).
  5. İndir aynı pencereyi o indirmenin durum görünümüne çevirir: duraklat/sürdür ya da yeniden dene, iptal et ve tamamlanan dosya eylemleri. Son bayta ulaşan bir iş, birleştirme ve doğrulama bitene kadar tamamlanmış sayılmaz; Dosyayı aç ve Klasörde göster yalnızca tamamlanmada etkinleşir. İndir (download) turns that same window into the download's own status view: pause/resume or retry, cancel and completed-file actions. A job that reached its last byte is not complete while its tracks are still being combined and checked; only completion enables Dosyayı aç (open the file) and Klasörde göster (show it in its folder).

Pencereyi kapatmak iptal etmek değildir: izlenen işler çalışmaya devam eder ve ana pencerede kalır. Closing the window is not cancelling: the tracked jobs keep running and stay in the main window.

Normal dosyaNormal files

Normal bir dosya bağlantısına sağ tıklayın ve Bağlantıyı SSDownload ile indir seçeneğini kullanın. Seçiciyi atlayan tek gönderim budur. Right-click an ordinary file link and use Bağlantıyı SSDownload ile indir (download the link with SSDownload). It is the only submission that skips the picker.

Sesi/Videoyu..., Sayfayı... ve İndirme penceresini aç... girdileriyle Kaynak seç listesinin her satırı, o kaynağın kendisi için masaüstü seçicisini açar; birkaç kaynağı olan bir sayfa sizin yerinize karar vermez. The Sesi/Videoyu... (audio/video), Sayfayı... (page) and İndirme penceresini aç... (open the download window) entries and every row of the Kaynak seç (choose source) list open the desktop picker for that exact source; a page with several sources never decides for you.

Oturum çerezleriSession cookies

Bir indirme sitenin oturum çerezlerini gerektiriyorsa, site başına Bu site için oturum çerezlerine izin ver ile izin verin ve Site oturum iznini kaldır ile geri alın. Bu hareket olmadan hiçbir şey okunmaz ve verilen izin yalnızca verildiği sekmenin çerez deposu için geçerlidir. When a download needs a site's session cookies, grant them per site with Bu site için oturum çerezlerine izin ver (allow session cookies for this site) and withdraw them with Site oturum iznini kaldır (remove the site session grant). Nothing is read without that gesture, and the grant only applies to the cookie store of the tab it was given in.

Bir indirme yeni bir kaynak adresi beklediğinde Tarayıcı aktarımı (kaynak yenileme)... bu aktarımı geçerli sekmede başlatır veya yeniden başlatır. When a download is waiting for a new source address, Tarayıcı aktarımı (kaynak yenileme)... (browser transfer, source renewal) starts or restarts that browser transfer in the current tab.

Kullanım profilleriUsage profiles

İlk çalıştırmada bir kerelik bir sihirbaz açılır: SSDownload'u ne için kullanacaksınız? penceresi Video, Dosya ve Ses kartlarını çoklu seçim olarak sunar, Başla ile onaylanır ve İptal ile kapatılır. Aynı seçimler Ayarlar'daki Kullanım amacı: bölümünden ve oradaki Sihirbazı yeniden aç... düğmesinden değiştirilebilir. A one-time wizard opens on first start: the SSDownload'u ne için kullanacaksınız? window offers the Video, Dosya and Ses cards (video, file, audio) as a multi-select, is confirmed with Başla (start) and dismissed with İptal (cancel). The same choices can be changed in the Kullanım amacı: (usage purpose) section of Settings and through its Sihirbazı yeniden aç... (reopen the wizard) button.

  • Bir profili kapatmak yalnızca yeni işleri engeller; var olan indirmeler ile onların duraklat, sürdür ve kaldır eylemleri etkilenmez. Disabling a profile gates new jobs only; existing downloads and their pause, resume and remove actions are unaffected.
  • Videonun kendi içindeki ses ve altyazılar tek başına Ses profiline bağlı değildir; bir video sayfası ayrıca açık bir ses çıkarma işinin kaynağı olabilir. A video's own audio and subtitles do not depend on the standalone Audio profile, and a video page may also be the source of an explicit audio-extraction job.
  • Çalışan pencereler kompakttır; kuyruk yöneticisi, klasör kuralları, site gezgini, eşitleme yöneticisi, olay günlüğü ve medya araçları ile indirme başına iş günlüğü penceresi 700x470 boyutunda açılır. Those windows are compact: the queue manager, folder rules, site crawler, sync manager, event log and media tools, like the per-download job log, all open at 700x470.

AyarlarSettings

Ayarlar sekmeli bir penceredir ve iki sekme de kaydırma çubuğu olmadan sığar. Ayarlar Araçlar → "Ayarlar..." altındadır. Settings is a tabbed window and both tabs fit without scrollbars. It lives under Araçlar → "Ayarlar..." (Tools → "Settings...").

GenelGeneral

AyarSetting Ne yaparWhat it does
Varsayılan indirme klasörü: Yeni indirmelerin hedefi; Gözat... klasörü seçer. Hedefi değiştirmek var olan işleri taşımaz. Destination of new downloads; Gözat... (browse) picks the folder. Changing it does not move existing jobs.
Kullanım amacı: Video, Dosya ve Ses profilleri; Sihirbazı yeniden aç... sihirbazı yeniden gösterir. The Video, File and Audio profiles; Sihirbazı yeniden aç... shows the wizard again.
Panodaki yeni URL'leri algıla Panodaki yeni bağlantılar bildirilir; kendiliğinden indirme formu açılmaz. New links on the clipboard are announced; no download form opens by itself.
Pencere kapatıldığında bildirim alanına küçült Pencereyi kapatmak uygulamayı kapatmaz, bildirim alanına indirir. Closing the window minimises to the notification area instead of exiting.
Windows oturum açılışında başlat Uygulamayı Windows oturum açılışında başlatır. Starts the application when the Windows session opens.
İndirme tamamlanınca bildirim göster Tamamlanan indirme için bildirim gösterir. Shows a notification when a download is completed.
Koyu pencere başlığı ve denetim teması Pencere başlığını ve denetimleri koyu temada çizer. Draws the title bar and controls in the dark scheme.
Günlük çalışma saatlerini sınırla Başlangıç (SS:DD): dahil, Bitiş (SS:DD): hariç; 23:00–07:00 gece yarısını aşar ve iki uç aynıysa gün boyu sürer. Aralık yerel saatle uygulanır. Başlangıç (SS:DD): (start time) is inclusive and Bitiş (SS:DD): (end time) exclusive; 23:00–07:00 crosses midnight, and equal endpoints mean all day. The window applies in local time.
Başlangıçta güncellemeleri denetle (günde en fazla bir kez) İmzalı güncelleme akışını günde en fazla bir kez denetler; Güncellemeleri şimdi denetle... elle denetler. Checks the signed update feed at most once a day; Güncellemeleri şimdi denetle... checks manually.
Eklentiyi tarayıcılara kur... Yönetilen cihazlarda eklenti ilkesini yazar; diğer cihazlarda nedenini bildirip paketlenmemiş kopyaya yönlendirir. Writes the extension policy on managed devices; elsewhere it reports why and points back at the unpacked copy.

GelişmişAdvanced

AyarSetting Ne yaparWhat it does
Aynı anda etkin iş (1–16): Aynı anda çalışabilecek iş sayısı. How many jobs may run at the same time.
Dosya aralığı bağlantısı (1–16): Bölümlü dosya aktarımında kullanılan bağlantı sayısı. Connections used by a segmented file transfer.
Medya parçası eşzamanlılığı (1–16): Medya parçaları için eşzamanlılık; varsayılan 4. Parallelism for media fragments; defaults to 4.
Sunucu başına iş ve bağlantı (1–16): Tek bir sunucuya karşı toplam eşzamanlılık sınırı. Total concurrency limit against one host.
Genel hız sınırı (KiB/sn, 0 = sınırsız): Genel indirme hızı sınırı. Overall download speed limit.
Yeniden deneme sayısı (0–20): Başarısız bir aktarımın yeniden deneme sayısı. Retry count for a failed transfer.
Deneysel tarayıcı aktarımını etkinleştir — büyük dosyalarda bellek ve bütünlük sınırları geçerlidir Varsayılan olarak kapalıdır ve normal indirmelerden ayrı bir yöntemdir. Off by default, and a method distinct from normal downloads.
Olay günlüğü: Kapalı, Yalnız hatalar, Normal veya Ayrıntılı; varsayılan Ayrıntılı. Off, errors only, normal or detailed; the default is detailed.
Site adlarını günlüğe kaydet Site ana makine adlarının günlüğe yazılıp yazılmayacağı; varsayılan açık. Whether site host names are recorded; on by default.

Klavye kısayollarıKeyboard shortcuts

Uygulama Yardım → "Klavye kısayolları" ile aynı dokuz satırı gösterir. The application shows the same nine lines through Yardım → "Klavye kısayolları" (Help → "Keyboard shortcuts").

TuşKey EylemAction
Ctrl+NYeni indirmeNew download
Ctrl+Shift+NVideo indir; yalnız ses profili etkinken bu girdi Ses indir... olarak okunur.Download video; while the audio-only profile is active this entry reads Ses indir....
Ctrl+VPanodaki URL'leri ekleAdd URLs from the clipboard
Ctrl+FAramaSearch
Ctrl+ATümünü seç; durum çubuğu seçim sayısını ekler.Select all; the status bar appends the selection count.
DeleteSeçilenleri kaldırRemove the selected jobs
F5YenileRefresh
EnterDosyayı açOpen the file
BoşlukSpaceDuraklat / sürdürPause or resume

Sorun gidermeTroubleshooting

Belirtiye karşılık gelen güvenli işlem. Bu adımlar hatayı gizlemez; hangi aşamanın başarısız olduğunu korur. The safe action for each symptom. These steps do not hide the failure; they preserve which stage failed.

BelirtiSymptom Güvenli işlemSafe action
Tarayıcı bağlanamıyorThe browser cannot connect Uygulama ve eklenti sürümlerini denetleyin, amaçlanan yürütülebilir dosyayı ve profili açıkça kaydedin. Başka bir kurulumun kaydının üzerine yazmayın. Check the application and extension versions and explicitly register the intended executable and profile. Do not overwrite another installation's registration.
Analizden sonra indirme etkinleşmiyorDownload stays disabled after analysis Hata ayrıntısını okuyun, kaynağı ve oturum bağlamını düzeltip yeniden analiz edin. Hazırlığı elle tahmin edilen bir adresle atlamayın. Read the error details, repair the source and session context and analyse again. Do not bypass preparation with a hand-guessed address.
Ses eksikMissing audio Yalnız video sunan bir kaynak sesi atladıysa, sesi de listeleyen asıl oynatıcı sayfasından hazırlayın. Eksik bilgi, sesin olmadığını kanıtlamaz. When a video-only source omitted its audio, prepare it from the parent player page that lists both. Missing information is not proof that there is no audio.
İstenen kalite veya parça kaybolduA requested quality or track disappeared Aynı kaynağı yeniden hazırlayın ve mevcut seçeneklerden açıkça seçin. Kalite, dil veya film sessizce değiştirilmez. Prepare the same source again and explicitly select an available option. Quality, language or film is never switched silently.
Kalıcı 403/TLS/DNS hatasıPersistent 403/TLS/DNS error Hatanın gerçekleştiği aşamayı koruyun. MP4'ten MKV'ye geçmek erişim kısıtlarını çözmez; TLS doğrulamasını kapatmayın ve sonsuz yeniden denemeyin. Preserve the stage that actually failed. Moving from MP4 to MKV does not solve access restrictions; do not disable TLS validation or retry indefinitely.
Oynatıcı çalışıyor ama yalnız parçalar geliyorThe player works but only fragments appear Sayfayı geçerli eklentiyle yenileyin. Açık Shadow DOM işlenir; kapalı kökler ve yalnız çalışan işçi gözlemleri sınırlı kalır. Reload the page with the current extension. Open Shadow DOM is handled; closed roots and worker-only observations stay bounded.
Birleştirme başarısız veya çalışma klasörü kalıyorA merge failed or a work directory remains Parçaları koruyun, yeterli alan açın ve aynı işi sürdürün. Boş çalışma üst klasörleri yinelenen indirme değildir. Keep the parts, free enough space and resume the same job. Empty work-parent directories are not duplicate downloads.
Kaldırma paylaşım ihlali bildiriyorRemoval reports a sharing violation O dosyayı kullanan süreci kapatın ve kaldırmayı yeniden deneyin; ilgisiz dosyaları özyinelemeli olarak silmeyin. Close the process using that file and retry the removal; do not delete unrelated files recursively.
Kuyruk kaydedilemiyorThe queue cannot be saved Kaydetme yeniden denenirken etkin işler duraklatılır ve yeni iş engellenir. Bu, otomatik bir disk veya veritabanı onarımı değildir. Active jobs are paused and new work is blocked while saving is retried. This is not automatic disk or database repair.
Şifreli bir iş yüklenemiyorOne encrypted job cannot be loaded Kaydı karantinaya alınır ve diğer işler yüklenebilir. Şifrelenmiş veri başka bir Windows hesabında açılamayabilir; müdahaleden önce veritabanını yedekleyin. Its record is quarantined and the other jobs still load. Encrypted data may not open under a different Windows account; back up the database before intervening.

Hata kodlarıError codes

Sınıflandırılmış hatalar kalıcı SSD-<alan>-<numara> kimlikleri taşır, örneğin SSD-MED-002. Kod destek ve otomasyon için kararlı bir tanımlayıcıdır; yanındaki Türkçe cümle insan tarafından okunacak ifade olarak kalır. Kodlar hiçbir zaman yeniden numaralanmaz veya başka bir anlama atanmaz. Classified failures carry permanent SSD-<area>-<number> identifiers, for example SSD-MED-002. The code is a stable identifier for support and automation; the Turkish sentence next to it stays the human-readable statement. Codes are never renumbered or reused.

Her hata bir kod taşımaz: geçersiz bir URL, başlık, iş, ayar, kuyruk girdisi, klasör kuralı, eşitleme hedefi veya gezgin ilkesi, işlem başlamadan önce sade bir Türkçe iletiyle reddedilir. Kodlar ileti listesinde, iş hatalarında, köprü iletilerinde, sayfa kaplamasında ve diagnostics.json içinde görünür. Not every failure carries a code: an invalid URL, header, job, setting, queue entry, folder rule, sync target or crawler policy is rejected before any operation starts, with a plain Turkish message. Codes appear in the message list, in job errors, in bridge messages, on the in-page overlay and in diagnostics.json.

AlanArea KapsamCovers
BRG Yerel köprü, eklenti kimliği ve protokol sürümüNative bridge, extension identity and protocol version
MED Kaynak adresi çözümleme, oynatma listeleri, medya parçaları ve dosya biçimi sınırlarıSource address resolution, playlists, media tracks and file-format limits
NET DNS ve TLS hataları, proxy tünelleri, HTTP durum kodu işleme, zaman aşımları ve yerel hız sınırlarıDNS and TLS failures, proxy tunnels, HTTP status handling, timeouts and local rate limits
TRF Aktarım, birleştirme, doğrulama, disk ve iş durumu hatalarıTransfer, merging, validation, disk and job-state failures
STO Kuyruk veritabanı, kalıcı durum, kuyruk kotası ve profil klasörü erişimiQueue database, persisted state, queue quota and profile-directory access
RCV Kurtarma günlüğü, dosya kimliği, saklanan kısmi parçalar ve kurtarma sahipliğiRecovery journal, file identity, kept partial pieces and recovery ownership
TOL Bileşen indirme, bütünlük ve sürüm denetimleriComponent download, integrity and version checks
UPD Güncelleme akışı, imza, indirme ve kurulum başlatmaUpdate feed, signature, download and installer start
EXT Köprü üzerinden bildirilen eklenti tarafı durumlarıExtension-side conditions reported back through the bridge