{head}

# How to use

{date}

### Supported sites

- https://github.com/KurtBestor/Hitomi-Downloader#supported-sites

### Address bar

- Type some URLs into the address bar and click the Download button to download
- Examples:
  https://hitomi.la/galleries/123.html
  https://hitomi.la/reader/123.html
  https://e-hentai.org/g/123/356dfa74ce/
  https://e-hentai.org/s/600e752112/123-4
  https://hiyobi.me/reader/123
  123
  https://www.pixiv.net/users/11
  https://www.pixiv.net/member_illust.php?id=11
  https://pixiv.me/pixiv
  pixiv_11
  https://twitter.com/TensorFlow
  @TensorFlow
  https://www.instagram.com/user_name
  insta_user_name
  https://username.deviantart.com
  deviant_username
- Examples for multiple URLs:
  123, 125, 126
  123 125 126
- Numbers not in Hitomi.la are automatically converted to E(x)Hentai URL.

### Save

- Save the preferences and tasks currently added.
- File - Save
- [Ctrl + S] key

### Searcher

- Search galleries
- Menu - Searcher...
- [Ctrl + F] key

### Downloader tasks

- Open the first file:
  Mouse right-click → [Open the first file]
  Click thumbnail
  Double-click
  [Enter] key
- Remove multiple tasks:
  Select multiple tasks → [Del] key
- Delete multiple files:
  Select multiple tasks → Mouse right-click → [Delete files]
  Select multiple tasks → [Shift] + [Del] key
- Remove all complete tasks:
  Mouse right-click → [Remove all complete tasks]
  Remove all complete tasks which are not locked.

### Task colors

- Light gray: Wating or Reading
- Dark gray: Downloading
- Green: Downloaded completely
- Orange: Downloaded incompletely
- Red: Fail or Invalid

### Change the order of tasks

- Drag and drop with the mouse wheel button to change the order.
- Following commands are also working: [Ctrl + ↑], [Ctrl + ↓], [Ctrl + Home], [Ctrl + End].

### Filtering the List of tasks

- Click the filter icon at the bottom left of the downloader window and type.
- Only tasks with a title that contains that word are visible.
- You can also filter by type, such as "type:youtube".
- If you type "dup:", you will see only duplicate tasks.
- Type "rem:" to see only the tasks that have been deleted from the physical storage.
- You can filter by tags such as "tag:glasses".
- You can filter by comments, such as "comment:xxxx".
- Type "bad:" to show only incomplete tasks.

### Searcher 검색 목록 필터링

- Searcher 좌측 하단의 필터 모양 아이콘을 클릭하고 내용 입력
- 해당 문자가 포함된 제목, 작가, 그룹, 태그, 언어를 가진 갤러리만 보입니다.
- "title:A" 를 입력하면 A라는 문자가 포함된 제목을 가진 갤러리만 보입니다.
- "artist:A", "group:A", "tag:A", "lang:A" 과 같이 필터링 할 수도 있습니다.
- "p<100" 을 입력하면 100 페이지 미만인 갤러리만 보입니다.
- "p>100" 을 입력하면 100 페이지 초과인 갤러리만 보입니다.
- "done:o" 를 입력하면 이미 다운로드한 갤러리만 보입니다.
- "done:x" 를 입력하면 아직 다운로드하지 않은 갤러리만 보입니다.

### 페이지 지정 다운로드

- 지정한 페이지만 다운로드합니다.
- Examples:
  ~ 100 → 앞 100 페이지
  -100 ~ → 뒤 100 페이지
  1, 10 ~ 20, -1 → 첫 페이지, 10 ~ 20 페이지, 마지막 페이지

### 선택 화 다운로드

- 선택한 화만 다운로드합니다.

### 환경 설정

- Options → Preferences

### 스레드

- Parallel downloads per task.
- 컴퓨터 사양이나 인터넷 상태가 좋지 않다면 갯수를 좀 더 내립니다.
- If you're unsure of this setting, keep the default values.

### Simple search - Search keywords

- Search like Google.
- Examples :
  maid
  maid glasses korean
  maid -schoolgirl
  maid n/a
  maid (korean + n/a)

### Advanced Search - Title

- Examples :
  maid
  maid -schoolgirl
  maid glasses

### Advanced Search - Artists

- Examples :
  sekiya asami
  sekiya asami + amezawa koma

### Advanced Search - Characters

- Examples :
  chino kafuu
  chino kafuu + kokoa hoto
  hino kafuu, kokoa hoto

### Advanced Search - Tags

- Examples :
  female:maid
  female:maid, -female:schoolgirl uniform

### Searcher 목록

- 여러 갤러리 다운로드 :
  여러 개 선택 → 마우스 우클릭 → [다운로드]
  여러 개 선택 → [Enter] key
- 갤러리 정보 보기 :
  마우스 우 클릭 → 갤러리 정보...
  Click thumbnail

### 검색 중 중단

- 검색 버튼 한번 더 클릭

### 파일이 제대로 다운로드 되지 않는 경우 (체크섬 오프로드 문제)

- 권장 (속도 떨어짐) :
  스레드 갯수를 낮게 조절합니다.
- 비권장 (속도 떨어지지 않음, 보안 문제 발생 가능) :
  제어판 → 시스템 → 하드웨어 → 장치관리자 → 네트워크 어댑터 → 무슨무슨 컨트롤러 → 우클릭 후 속성 → 고급 탭 → 무슨무슨 오프로드를 모두 '사용 안 함'으로 설정 → 확인
  조금 기다리면 인터넷이 다시 연결됩니다.

### Searcher 검색 데이터 업데이트

- Searcher - 메뉴 - 데이터 다운로드...
- 데이터를 다시 다운로드할 때마다 서버에서 최신 데이터를 가져옵니다.

### Scripts

- Tools - Import script...
- Execute python script.
- 다운로드 스크립트를 직접 만들어 추가하는 등 다양한 작업을 할 수 있습니다.
- 스크립트 파일 (*.hds) 은 텍스트에디터(메모장 등)로 수정할 수 있습니다.
- 스크립트 파일들을 프로그램에 드래그 & 드랍해서 실행시킬 수도 있습니다.
- 실행파일 경로에 scripts 폴더 만들고 스크립트 파일 (*.hds) 넣으면 시작할 때 자동으로 실행합니다.
- Download scripts :
  https://github.com/KurtBestor/Hitomi-Downloader/wiki/Scripts
- How to write a script :
  https://github.com/KurtBestor/Hitomi-Downloader/wiki/How-to-write-a-script

### Bypass DPI

- Options - Preferences - Advanced Settings - Bypass DPI
- GoodbyeDPITo block/ bypass DPI (Deep Packet Inspection).

### Load cookies

- Options - Preferences - Advanced Setting - Cookies - Load...
- Cookies exported from browser extensions can be loaded. (Netscape HTTP Cookie File)
- Using these cookies, Hitomi Downloader can access login-required pages.
- Chrome extension: cookies.txt, Get cookies.txt
- Firefox extension: cookies.txt
- Edge extension: Get cookies.txt
- Expired cookies are shown in gray.

### Built-in Web browser

- Options - Preferences - Advanced Setting - Built-in Web browser - View
- Used to read pages that require JS rendering.
- You can use this to update cookies.

### Chrome Extension

- Hitomi Downloader
- Functions:
  Download sites that require the extension
  Update cookies

### Save

- Save & Quit :
  Quit with saving settings and currently added lists
- Quit :
  Quit without saving
- When launching the app, it starts with the most recent saved state.

### Shortcuts

- Alt + D : Address bar ↔ toggle task list
- Ctrl + 1 ~ 7 : Set tags in tasks
- Ctrl + Tab : Show/Hide Toolbar
- Ctrl + - / + : Thumbnail size adjustment
- Ctrl + Scroll : Thumbnail size adjustment
- Space : Expand/Collapse Group(s)

### Feedback

- https://github.com/KurtBestor/Hitomi-Downloader/issues

### Etc.

- Please use the downloaded files for personal use only.
- Please look for further updates at Help - About - Bottom button.