Skip to content
EnesSoydanPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Annotie Logo

Annotie

YOLO formatında veri seti etiketleme için ücretsiz, açık kaynaklı masaüstü uygulaması
Free, open-source desktop annotation tool for YOLO-format datasets

Python PySide6 Platform License Release


TR Türkçe | EN English


Annotie Demo

Annotie Nedir?

Annotie, YOLO formatında veri seti oluşturmak ve yönetmek için geliştirilmiş masaüstü görsel etiketleme uygulamasıdır. Tüm YOLO görev tiplerini tek bir araçta destekler -- abonelik yok, limit yok, bulut yüklemesi yok.


Özellikler

Desteklenen Etiket Tipleri

Tip YOLO Görevi
Bounding Box (BBox) Detection (Nesne Tespiti)
Polygon Segmentation (Segmentasyon)
Oriented Bounding Box (OBB) OBB Detection
Keypoints Pose Estimation (Poz Tahmini)
Classification Image Classification (Görüntü Sınıflandırma)

Aynı veri setinde farklı etiket tipleri bir arada kullanılabilir. YOLOv5, v8, v10, v11, v12 ve sonrası ile uyumludur.

Gerçek Zamanlı İşbirliği (Collaboration)

Annotie, birden fazla kişinin aynı veri seti üzerinde eş zamanlı çalışmasına olanak tanır -- aynı odada veya dünya üzerinde farklı lokasyonlarda.

Collaboration Demo

Nasıl Çalışır:

  1. Bir kullanıcı Lobi Oluştur'a tıklar, 6 haneli bir kod üretilir
  2. Diğer kullanıcılar bu kodu girerek lobiye katılır
  3. Tüm annotation değişiklikleri (oluşturma, silme, taşıma, sınıf değiştirme) anlık olarak senkronize edilir

Özellikler:

  • Lobi tabanlı sistem -- kod paylaşarak davet
  • Annotation oluşturma, silme, boyutlandırma ve sınıf değişikliği anlık sync
  • Sınıf ekleme, silme ve yeniden adlandırma sync
  • Presence sistemi -- kim hangi görselde çalışıyor gösterilir
  • Aynı görselde başka biri çalışıyorsa uyarı banner'ı
  • Otomatik yeniden bağlanma ve mesaj kuyruklama
  • Sunucu ücretsiz olarak Render.com üzerinde çalışır -- sıfır maliyet

Veri Seti Yönetimi

  • Standart YOLO klasör yapısını otomatik tanır, data.yaml dosyasını (sınıflar, yollar) otomatik okur
  • Train / Validation / Test / Atanmamış split sistemi -- her görsele split atanabilir
  • İki farklı görsel import modu:
    • Ekle (Add) -- mevcut split korunur, yeni görseller eklenir
    • Üzerine Yaz (Replace) -- seçilen split temizlenir, yeni görseller yazılır
  • Etiket import -- başka bir klasördeki .txt dosyalarını dosya adı eşleştirme ile mevcut görsellere uygular
  • Export -- standart YOLO yapısında ve otomatik oluşturulan data.yaml ile export eder; arka planda çalışır, canlı ilerleme barı gösterir (arayüz donmaz)

Beklenen Klasör Yapısı

dataset/
+-- train/
|   +-- images/
|   |   +-- image1.jpg
|   +-- labels/
|       +-- image1.txt
+-- valid/
|   +-- images/
|   |   +-- image2.jpg
|   +-- labels/
|       +-- image2.txt
+-- test/
|   +-- images/
|   |   +-- image3.jpg
|   +-- labels/
|       +-- image3.txt
+-- data.yaml

Annotie bu yapıyı açılışta okur, export'ta aynı yapıda yazar -- Ultralytics YOLO ile doğrudan kullanıma hazır.

Etiketleme Arayüzü

  • Tıkla-bırak ile etiket çizimi -- tıkla = etiket koy, sürükle = canvas'ı kaydır
  • Zoom seviyesinden bağımsız sabit boyutlu köşe tutamaçları, yalnızca hover/seçimde görünür
  • Undo / Redo desteği
  • Otomatik kaydetme -- her değişiklik anında .txt dosyasına otomatik yazılır

Navigasyon

  • A / D -- önceki / sonraki görsel (tüm görseller)
  • <- / -> -- yalnızca etiketli görseller arası geçiş
  • Sol panel, klavye navigasyonunda otomatik olarak highlight ve scroll takibi yapar
  • Split sekmeleri göreli numaralandırma gösterir (Eğitim sekmesindeki 1. görsel, global indeksten bağımsızdır)

Son Kaldığın Yer (Position Memory)

Büyük veri setlerinde çalışırken en işe yarayan özelliklerden biri:

  • Konum veri seti başına, split başına (Tümü / Eğitim / Doğrulama / Test) ayrı ayrı kaydedilir
  • Yalnızca "Tümü" sekmesinde gezseniz bile, her görselin hangi split'e ait olduğu bilindiğinden split bazlı konumlar da güncellenir
  • Her veri seti geçişinde (kapatma, yeni açma, son açılanlar) otomatik kaydedilir
  • Bir sonraki açılışta: "Eğitim kategorisinde 150. frame'de kaldınız"
  • Split sekmesine tıklandığında da o kategorideki son konum gösterilir

Arayüz / UX

  • Koyu tema (Dark mode)
  • Toast bildirimleri -- yeşil (başarı) / kırmızı (hata), animasyonlu kaybolma
  • Veri seti açılışında etiketli / etiketsiz görsel sayısı, data.yaml eksikse uyarı
  • Son açılan veri setleri listesi, konum hafızasıyla
  • Pencere durumu (boyut, panel konumları) kaydedilir ve restore edilir
  • Odak Modu (F12) -- tüm paneller gizlenir, yalnızca canvas kalır

İndirme

Hazır kurulum dosyaları Releases sayfasında mevcuttur.

Platform Dosya Gereksinim
Windows Annotie-Windows.zip Windows 10/11 (64-bit)
macOS Annotie-macOS.zip macOS 11.0+ (Intel & Apple Silicon)

Windows: ZIP'i çıkart, Annotie.exe dosyasını çalıştır.

macOS: ZIP'i çıkart, Annotie.app dosyasını Uygulamalar klasörüne taşı.


Güvenlik Uyarısı (Normal -- Beklenen Bir Durum)

Annotie ücretli bir Apple/Microsoft geliştirici sertifikasıyla imzalanmamıştır. Bu nedenle ilk açılışta her iki platformda da güvenlik uyarısı görebilirsiniz. Bu tamamen normaldir; uygulama zararlı değildir, kaynak kodunun tamamı bu repoda açık olarak mevcuttur.

macOS -- "Annotie Açılmadı" Uyarısı

Yöntem 1 -- Sağ tık ile aç (En kolay):

  1. Annotie.app dosyasına sağ tıkla
  2. "Aç" seç
  3. Çıkan uyarıda "Aç" butonuna bas -- bu adımdan sonra bir daha sormaz

Yöntem 2 -- Sistem Ayarları:

  1. Uygulamayı bir kez çift tıkla (uyarı çıkacak, kapat)
  2. Sistem Ayarları - Gizlilik ve Güvenlik bölümüne git
  3. En alta in - "Yine de Aç" butonuna tıkla

Yontem 3 -- Terminal:

sudo xattr -rd com.apple.quarantine /Applications/Annotie.app

Windows -- SmartScreen Uyarısı

  1. "Daha fazla bilgi" bağlantısına tıkla
  2. "Yine de çalıştır" butonuna bas

Kaynaktan Çalıştır

git clone https://github.com/EnesSoydan/Annotie.git
cd Annotie
pip install -r requirements.txt
python main.py

Gereksinimler: Python 3.10+

PySide6>=6.6.0
Pillow>=10.0.0
PyYAML>=6.0
numpy>=1.24.0

Code Signing Policy

Windows için ücretsiz kod imzalama hizmeti SignPath.io tarafından sağlanmakta olup sertifika SignPath Foundation tarafından verilmektedir.

Rol Kişi
Geliştirici & Onaylayıcı EnesSoydan

Bu uygulama, kullanıcı tarafından açıkça talep edilmedikçe herhangi bir bilgiyi harici sistemlere iletmez.


Lisans

GPL-3.0 Lisansı -- ücretsiz kullanım ve değiştirme serbesttir; türetilmiş çalışmalar da aynı lisansla açık kaynak olarak dağıtılmalıdır.



EN English

Annotie Demo

What is Annotie?

Annotie is a desktop image annotation application built for creating and managing YOLO-format datasets. It supports all major YOLO task types in a single tool -- no subscriptions, no limits, no cloud uploads.


Features

Annotation Types

Type YOLO Task
Bounding Box (BBox) Detection
Polygon Segmentation
Oriented Bounding Box (OBB) OBB Detection
Keypoints Pose Estimation
Classification Image Classification

Mixed annotations are supported -- different label types can coexist in the same dataset. Compatible with all YOLO versions (v5, v8, v10, v11, v12+).

Real-Time Collaboration

Annotie allows multiple people to work on the same dataset simultaneously -- whether in the same room or across different locations worldwide.

How It Works:

  1. One user clicks Create Lobby and a 6-digit code is generated
  2. Others join the lobby by entering the code
  3. All annotation changes (create, delete, move, class change) sync instantly

Features:

  • Lobby-based system -- invite by sharing a code
  • Instant sync for annotation creation, deletion, resizing, and class changes
  • Class addition, deletion, and renaming sync
  • Presence system -- see who is working on which image
  • Warning banner when someone else is editing the same image
  • Automatic reconnection and message queuing
  • Server runs free on Render.com -- zero cost

Dataset Management

  • Auto-detects standard YOLO folder structure and reads data.yaml (classes, paths) automatically
  • Train / Validation / Test / Unassigned split system -- assign any image to any split
  • Two import modes for images:
    • Add -- append new images while keeping existing ones
    • Replace -- clear the selected split and write fresh
  • Label import -- apply .txt annotation files from any folder by matching filenames
  • Export -- produces the standard YOLO structure with an auto-generated data.yaml, runs in the background with a live progress bar (UI never freezes)

Expected Folder Structure

dataset/
+-- train/
|   +-- images/
|   |   +-- image1.jpg
|   +-- labels/
|       +-- image1.txt
+-- valid/
|   +-- images/
|   |   +-- image2.jpg
|   +-- labels/
|       +-- image2.txt
+-- test/
|   +-- images/
|   |   +-- image3.jpg
|   +-- labels/
|       +-- image3.txt
+-- data.yaml

Annotie reads this structure on open and writes it back on export -- ready to use directly with Ultralytics YOLO.

Annotation Interface

  • Click to annotate -- click to place points/boxes, drag to pan the canvas
  • Fixed-size corner handles independent of zoom level, visible only on hover/select
  • Undo / Redo support
  • Auto-save -- changes are written to .txt files instantly

Navigation

  • A / D -- previous / next image (all images)
  • <- / -> -- previous / next labeled image only
  • Image list panel auto-scrolls and highlights current image on keyboard navigation
  • Split tabs show relative numbering (e.g. image #1 in the Val tab is independent of its global index)

Last Position Memory

One of the most useful features for large datasets:

  • Saves your position per dataset, per split (All / Train / Val / Test)
  • Even if you only browse in the All tab, per-split positions are tracked since each image's split is already known
  • Position is saved on every dataset switch -- not just on app close
  • On next open: "You left off at frame 150 in the Training split"
  • Clicking a split tab also shows where you left off in that split

UI / UX

  • Dark theme
  • Toast notifications -- green (success) / red (error) with fade-out animation
  • On dataset open: shows labeled vs. unlabeled image count, warns if data.yaml is missing
  • Recent files list with position memory per dataset
  • Window state (size, panel positions) saved and restored
  • Focus Mode (F12) -- hides all panels, only the canvas remains

Download

Pre-built binaries are available on the Releases page.

Platform File Requirements
Windows Annotie-Windows.zip Windows 10/11 (64-bit)
macOS Annotie-macOS.zip macOS 11.0+ (Intel & Apple Silicon)

Windows: Extract the ZIP and run Annotie.exe

macOS: Extract the ZIP, move Annotie.app to Applications.


Security Warning (Normal -- Expected Behavior)

Annotie is not signed with a paid Apple/Microsoft developer certificate. Because of this, both platforms may show a security warning on first launch. This is completely normal -- the app is safe, and the full source code is publicly available in this repository.

macOS -- "Annotie cannot be opened" Warning

Method 1 -- Right-click to open (Easiest):

  1. Right-click Annotie.app
  2. Select "Open"
  3. Click "Open" in the dialog -- it won't ask again after this

Method 2 -- System Settings:

  1. Double-click the app once (warning will appear, close it)
  2. Go to System Settings - Privacy & Security
  3. Scroll down - click "Open Anyway"

Method 3 -- Terminal:

sudo xattr -rd com.apple.quarantine /Applications/Annotie.app

Windows -- SmartScreen Warning

  1. Click "More info"
  2. Click "Run anyway"

Run from Source

git clone https://github.com/EnesSoydan/Annotie.git
cd Annotie
pip install -r requirements.txt
python main.py

Requirements: Python 3.10+

PySide6>=6.6.0
Pillow>=10.0.0
PyYAML>=6.0
numpy>=1.24.0

Code Signing Policy

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

Role Member
Developer & Approver EnesSoydan

This program will not transfer any information to other networked systems unless specifically requested by the user.


License

GPL-3.0 License -- free to use and modify; derivative works must be distributed under the same license as open source.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages