appcask 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 84b4342166055f34caca13c015782050cc53a3b822def01f171d5b7a3b46cfd6
+  data.tar.gz: 2d3a8ae4795e748adcc170cb9a718604fe121b1342a87dc562a6c7cf7db62ad2
+SHA512:
+  metadata.gz: d352aaccc7f028d535de981d1381d924f9e01c572cd5ccebd37950ce645625f22c2b38cd0eb0aa75cc8c6fbaec0b930d6659e3e0e0438323b1af8a86460f1685
+  data.tar.gz: e7f972f9abfafb77b5e8bb62af302b51eb61e3e0702a08979941265f7a52d7dda260a848c6d2eca8448d4bfd5fa7d5ec207c2b4ebe60e43bf74c89a06f41ab00

data/.idea/workspace.xml

@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="1bd4c817-c426-471c-bdf5-e80649db2ae2" name="更改" comment="">
+      <change afterPath="$PROJECT_DIR$/.github/workflows/main.yml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/.gitignore" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/.rubocop.yml" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/CHANGELOG.md" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/CODE_OF_CONDUCT.md" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/Gemfile" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/LICENSE.txt" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/Rakefile" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/appcask.gemspec" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/bin/console" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/bin/setup" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/examples/batch_download.rb" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/lib/appcask.rb" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/lib/appcask/version.rb" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/sig/appcask.rbs" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/test/test_appcask.rb" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/test/test_helper.rb" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 3
+}]]></component>
+  <component name="ProjectId" id="38w4u8bpa7evnl9Tft1pg9mpNsJ" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ASKED_SHARE_PROJECT_CONFIGURATION_FILES": "true",
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "git-widget-placeholder": "main",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "ruby.structure.view.model.defaults.configured": "true",
+    "settings.editor.selected.configurable": "preferences.lookFeel",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-9b0f141eb926-JavaScript-RM-253.30387.79" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="SpringUtil" SPRING_PRE_LOADER_OPTION="true" RAKE_SPRING_PRE_LOADER_OPTION="true" RAILS_SPRING_PRE_LOADER_OPTION="true" />
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="1bd4c817-c426-471c-bdf5-e80649db2ae2" name="更改" comment="" />
+      <created>1767270112011</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1767270112011</updated>
+      <workItem from="1767270116395" duration="20000" />
+      <workItem from="1769697520161" duration="3786000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

data/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2026-01-29
+
+### 🎉 AppCask 首次发布
+
+#### 🆕 下载模式
+- ✨ **图标下载** - 4 种尺寸可选 (60x60 到 1024x1024)
+- 📸 **截图下载** - 支持 iPhone 和 iPad 截图批量下载
+- 📝 **应用信息导出** - 3 种格式 (TXT/JSON/Markdown)
+- 📦 **完整包下载** - 一键下载所有资源
+
+#### 📋 应用信息字段
+- 基本信息：名称、ID、Bundle ID、开发者
+- 版本信息：版本号、文件大小、系统要求、支持设备
+- 评分数据：平均评分、评分数量
+- 价格信息：价格、货币
+- 分类信息：主分类、所有分类
+- 内容信息：应用描述、版本更新说明
+- 链接信息：App Store 链接、开发者网站
+
+#### 🌍 更多区域
+新增支持：
+- 🇹🇼 台湾 (tw)
+- 🇬🇧 英国 (gb)
+- 🇩🇪 德国 (de)
+- 🇫🇷 法国 (fr)

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"appcask" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["TODO: Write your email address"](mailto:"TODO: Write your email address").

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Billow Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,249 @@
+# AppCask - App Store 资源下载工具
+
+<div align="center">
+
+![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)
+![Ruby](https://img.shields.io/badge/ruby-%3E%3D%202.5.0-red.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+
+一个全能的命令行工具,用于下载 iOS App Store 的应用资源  
+**图标 · 截图 · 应用简介 · 一键打包**
+
+[功能特性](#-功能特性) • [安装](#-安装) • [使用指南](#-使用指南) • [示例](#-使用示例)
+
+</div>
+
+---
+
+## ✨ 功能特性
+
+### 🎨 图标下载
+- 支持 4 种尺寸：60x60、100x100、512x512、1024x1024
+- 自动检测图片格式 (PNG/JPG/GIF/WEBP)
+- 智能文件命名
+
+### 📸 截图下载
+- iPhone 截图
+- iPad 截图
+- 批量下载所有截图
+- 自动分类保存
+
+### 📝 应用信息导出
+- **TXT 格式** - 易读的文本文件
+- **JSON 格式** - 结构化数据
+- **Markdown 格式** - 精美的文档
+
+包含信息：
+- 基本信息（名称、开发者、Bundle ID）
+- 版本信息（当前版本、文件大小、系统要求）
+- 评分统计（平均分、评分数量）
+- 价格信息
+- 应用描述
+- 版本更新说明
+- 相关链接
+
+### 📦 一键完整包
+下载应用的所有资源，包括：
+- 所有尺寸的图标
+- 所有设备的截图
+- 完整的应用信息（3种格式）
+
+### 🌍 多区域支持
+- 🇺🇸 美国 (us)
+- 🇨🇳 中国 (cn)
+- 🇯🇵 日本 (jp)
+- 🇰🇷 韩国 (kr)
+- 🇭🇰 香港 (hk)
+- 🇹🇼 台湾 (tw)
+- 🇬🇧 英国 (gb)
+- 🇩🇪 德国 (de)
+- 🇫🇷 法国 (fr)
+
+---
+
+## 📦 安装
+
+```bash
+gem install appcask
+```
+
+或从源码安装:
+
+```bash
+git clone https://github.com/yourusername/appcask.git
+cd appcask
+bundle install
+rake build
+gem install pkg/appcask-1.0.0.gem
+```
+
+---
+
+## 🚀 快速开始
+
+```bash
+# 交互模式
+appcask
+
+# 快速搜索
+appcask "Instagram"
+
+# 指定区域
+appcask "微信" cn
+```
+
+### 完整演示
+
+```
+$ appcask "Twitter"
+
+╔═══════════════════════════════════════════╗
+║      AppCask - App 资源下载工具           ║
+║              v1.0.0                       ║
+╚═══════════════════════════════════════════╝
+
+🔍 正在搜索 "Twitter"...
+
+📋 找到 3 个结果:
+
+  [0] X
+      开发者: X Corp. | 版本: 10.31
+      价格: Free | 评分: ⭐ 4.2
+
+请选择 (0-2, 或按q退出): 0
+
+✅ 已选择: X
+
+📦 选择下载内容:
+  [1] 图标
+  [2] 截图
+  [3] 简介信息
+  [4] 完整包(图标+截图+简介)
+
+请选择 (1-4): 4
+
+✨ 下载完成!
+📁 ~/Desktop/AppCask Downloads/X
+📊 统计: 15 个文件, 总大小 8.45 MB
+```
+
+---
+
+## 📖 使用示例
+
+### 仅下载图标
+
+```bash
+appcask "Instagram"
+# 选择: [1] 图标 → [3] 1024x1024
+```
+
+### 下载所有截图
+
+```bash
+appcask "王者荣耀" cn
+# 选择: [2] 截图 → all
+```
+
+### 导出应用信息
+
+```bash
+appcask "Notion"
+# 选择: [3] 简介信息
+# 输出: TXT + JSON + Markdown
+```
+
+### 批量下载
+
+```ruby
+#!/usr/bin/env ruby
+
+apps = ['Instagram', 'Twitter', 'Facebook']
+
+apps.each do |app|
+  system("appcask '#{app}'")
+  sleep 2
+end
+```
+
+---
+
+## 📂 文件结构
+
+```
+AppCask Downloads/
+└── Instagram/
+    ├── icons/
+    │   ├── icon-60x60.png
+    │   ├── icon-100x100.png
+    │   ├── icon-512x512.png
+    │   └── icon-1024x1024.png
+    ├── screenshots/
+    │   ├── iPhone/
+    │   └── iPad/
+    ├── app_info.txt
+    ├── app_info.json
+    └── README.md
+```
+
+---
+
+## 🔧 高级功能
+
+### Debug 模式
+
+```bash
+DEBUG=1 appcask "AppName"
+```
+
+### 快捷操作
+
+- **回车** - 默认选项
+- **q** - 退出
+- **Ctrl+C** - 中断
+
+---
+
+## 🐛 故障排除
+
+**Q: 搜索不到应用？**  
+A: 确认拼写、尝试切换区域
+
+**Q: 图标尺寸不对？**  
+A: 部分应用不支持 1024x1024
+
+**Q: 网络超时？**  
+A: 检查网络、使用 VPN
+
+**Q: 文件保存在哪？**  
+A: `~/Desktop/AppCask Downloads/`
+
+---
+
+## 🎯 路线图
+
+- [ ] macOS App Store 支持
+- [ ] 应用评论下载
+- [ ] 批量下载模式
+- [ ] Web 界面
+
+---
+
+## 📄 许可证
+
+MIT License
+
+---
+
+## 📮 联系
+
+- GitHub: [@yourusername](https://github.com/yourusername)
+- Issues: [反馈问题](https://github.com/yourusername/appcask/issues)
+
+---
+
+<div align="center">
+
+**Made with ❤️ and Ruby**
+
+</div>

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/examples/batch_download.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+# AppCask batch download example
+# Usage: ruby examples/batch_download.rb
+
+require 'appcask'
+
+# Define the list of apps to download
+apps = [
+  { name: 'Instagram', region: 'us', description: 'Social media app' },
+  { name: 'Twitter',   region: 'us', description: 'Microblogging platform' },
+  { name: 'WeChat',    region: 'cn', description: 'Instant messaging app' },
+  { name: 'LINE',      region: 'jp', description: 'Messaging app popular in Japan' },
+  { name: 'KakaoTalk', region: 'kr', description: 'Messaging app popular in Korea' }
+]
+
+puts '=' * 50
+puts 'AppCask Batch Download Script'
+puts '=' * 50
+puts "\nPreparing to download resources for #{apps.size} apps...\n\n"
+
+apps.each_with_index do |app, index|
+  puts "\n[#{index + 1}/#{apps.size}] Processing: #{app[:name]} (#{app[:description]})"
+  puts '-' * 50
+
+  # Set command-line arguments
+  ARGV.clear
+  ARGV << app[:name] << app[:region]
+
+  begin
+    # Run AppCask
+    AppCask.main
+    puts "✅ #{app[:name]} downloaded successfully."
+  rescue StandardError => e
+    puts "❌ Failed to download #{app[:name]}: #{e.message}"
+  end
+
+  # Pause to avoid sending requests too frequently
+  sleep 2 unless index == apps.size - 1
+end
+
+puts "\n" + '=' * 50
+puts 'Batch download completed!'
+puts '=' * 50

data/lib/appcask/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Appcask
+  VERSION = "0.1.0"
+end

data/lib/appcask.rb

@@ -0,0 +1,627 @@
+# frozen_string_literal: true
+
+require 'appcask/version'
+require 'net/https'
+require 'open-uri'
+require 'json'
+require 'fileutils'
+
+module AppCask
+  class Error < StandardError; end
+
+  ICON_SIZES = {
+    '0' => { display: '60x60', key: 'artworkUrl60' },
+    '1' => { display: '100x100', key: 'artworkUrl100' },
+    '2' => { display: '512x512', key: 'artworkUrl512' },
+    '3' => { display: '1024x1024', key: 'artworkUrl512' }
+  }.freeze
+
+  SCREENSHOT_DEVICES = {
+    'iphone' => 'iPhone screenshots',
+    'ipad' => 'iPad screenshots'
+  }.freeze
+
+  COUNTRIES = {
+    'us' => 'United States',
+    'cn' => 'China',
+    'jp' => 'Japan',
+    'kr' => 'South Korea',
+    'hk' => 'Hong Kong',
+    'tw' => 'Taiwan',
+    'gb' => 'United Kingdom',
+    'de' => 'Germany',
+    'fr' => 'France'
+  }.freeze
+
+  DOWNLOAD_MODES = {
+    '1' => { name: 'Icon Only', method: :download_icon },
+    '2' => { name: 'Screenshots Only', method: :download_screenshots },
+    '3' => { name: 'Description Only', method: :download_description },
+    '4' => { name: 'All Assets', method: :download_all }
+  }.freeze
+
+  class << self
+    def main
+      begin
+        get
+      rescue Interrupt
+        puts "\n\n👋 Goodbye!"
+        exit 0
+      rescue StandardError => e
+        warn "\n❌ Error: #{e.message}"
+        warn e.backtrace if ENV['DEBUG']
+        exit 1
+      end
+    end
+
+    def get
+      show_banner
+
+      app_name = get_app_name
+      country = get_country
+
+      puts "\n🔍 Searching for \"#{app_name}\"..."
+
+      results = search_app(app_name, country)
+
+      if results.nil? || results['resultCount'].to_i.zero?
+        warn "❌ No apps found for \"#{app_name}\"."
+        return
+      end
+
+      selected_app = select_app(results)
+      return unless selected_app
+
+      mode = select_download_mode
+      return unless mode
+
+      send(mode[:method], selected_app, country)
+    end
+
+    private
+
+    def show_banner
+      puts <<~BANNER
+          ▄▖    ▄▖    ▌
+          ▌▌▛▌▛▌▌ ▀▌▛▘▙▘
+          ▛▌▙▌▙▌▙▖█▌▄▌▛▖
+            ▌ ▌
+          
+          v#{AppCask::VERSION}
+      BANNER
+    end
+
+    def get_app_name
+      if ARGV.count.positive?
+        ARGV[0]
+      else
+        print '📱 Enter the app name to search: '
+        $stdin.gets.chomp.strip
+      end
+    end
+
+    def get_country
+      return ARGV[1] if ARGV.count > 1 && COUNTRIES.key?(ARGV[1])
+
+      puts "\n🌍 Select App Store region:"
+      COUNTRIES.each_slice(3) do |slice|
+        puts "  " + slice.map { |code, name| "#{code.ljust(4)}- #{name}" }.join("    ")
+      end
+      print "Choose one (default: us): "
+
+      input = $stdin.gets.chomp.strip.downcase
+      input.empty? ? 'us' : (COUNTRIES.key?(input) ? input : 'us')
+    end
+    def search_app(app_name, country)
+      url = URI('https://itunes.apple.com/search')
+      params = {
+        term: app_name,
+        country: country,
+        media: 'software',
+        entity: 'software',
+        limit: '20'
+      }
+
+      http = Net::HTTP.new(url.host, url.port)
+      http.use_ssl = true
+      http.open_timeout = 10
+      http.read_timeout = 10
+
+      request = Net::HTTP::Post.new(url)
+      request.set_form_data(params)
+
+      response = http.request(request)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        warn "❌ Search failed: HTTP #{response.code}"
+        return nil
+      end
+
+      json = JSON.parse(response.body)
+
+      if json['resultCount'].zero?
+        warn '😕 No apps found. Please try a different keyword.'
+        return nil
+      end
+
+      json
+
+    rescue JSON::ParserError => e
+      warn "❌ Failed to parse response: #{e.message}"
+      nil
+    rescue Net::OpenTimeout, Net::ReadTimeout
+      warn '❌ Network timeout. Please check your connection.'
+      nil
+    rescue StandardError => e
+      warn "❌ Search error: #{e.message}"
+      nil
+    end
+
+    def select_app(results)
+      puts "\n📋 Found #{results['resultCount']} result(s):\n\n"
+
+      results['results'].each_with_index do |item, index|
+        developer = item['artistName'] || 'Unknown Developer'
+        price     = item['formattedPrice'] || item['price']
+        version   = item['version'] || 'N/A'
+        rating    = item['averageUserRating'] ? "⭐ #{item['averageUserRating'].round(1)}" : 'No Rating'
+
+        puts "  [#{index}] #{item['trackCensoredName']}"
+        puts "      Developer: #{developer} | Version: #{version}"
+        puts "      Price: #{price} | Rating: #{rating}"
+        puts
+      end
+
+      print "Select an app (0-#{results['resultCount'] - 1}, or press q to quit): "
+      input = $stdin.gets.chomp.strip
+
+      return nil if input.downcase == 'q'
+
+      index = input.to_i
+
+      unless valid_index?(index, results['resultCount'])
+        warn "❌ Invalid selection."
+        return nil
+      end
+
+      selected = results['results'][index]
+      puts "\n✅ Selected: #{selected['trackCensoredName']}"
+      selected
+    end
+
+    def select_download_mode
+      puts "\n📦 Select download content:\n"
+      DOWNLOAD_MODES.each do |key, value|
+        puts "  [#{key}] #{value[:name]}"
+      end
+
+      print "\nChoose an option (1-4): "
+      input = $stdin.gets.chomp.strip
+
+      unless DOWNLOAD_MODES.key?(input)
+        warn "❌ Invalid selection."
+        return nil
+      end
+
+      DOWNLOAD_MODES[input]
+    end
+
+    def download_icon(app_info, country)
+      puts "\n🎨 Downloading app icon\n"
+
+      size_info = select_icon_size
+      return unless size_info
+
+      artwork_url = app_info[size_info[:key]]
+
+      unless artwork_url
+        puts "❌ This app does not provide an icon at the selected size."
+        return
+      end
+
+      # If 1024x1024 is selected, replace 512 with 1024 in the URL
+      if size_info[:display].include?('1024')
+        artwork_url = artwork_url.gsub('512x512', '1024x1024')
+      end
+
+      puts "\n⬇️  Downloading icon..."
+
+      download_dir = create_app_directory(app_info, 'icons')
+      file_name = "icon-#{size_info[:display].split(' ').first}"
+
+      download_image(artwork_url, download_dir, file_name)
+    end
+
+    def download_screenshots(app_info, country)
+      puts "\n📸 Downloading app screenshots\n"
+
+      iphone_urls = app_info['screenshotUrls'] || []
+      ipad_urls   = app_info['ipadScreenshotUrls'] || []
+
+      if iphone_urls.empty? && ipad_urls.empty?
+        puts "❌ This app does not provide any screenshots."
+        return
+      end
+
+      puts "Available screenshots:"
+      puts "  iPhone: #{iphone_urls.count}" unless iphone_urls.empty?
+      puts "  iPad:   #{ipad_urls.count}"   unless ipad_urls.empty?
+
+      print "\nWhich device screenshots would you like to download? (iphone/ipad/all, default: all): "
+      device = $stdin.gets.chomp.strip.downcase
+      device = 'all' if device.empty?
+
+      download_dir = create_app_directory(app_info, 'screenshots')
+
+      case device
+      when 'iphone'
+        download_screenshot_set(iphone_urls, download_dir, 'iPhone')
+      when 'ipad'
+        download_screenshot_set(ipad_urls, download_dir, 'iPad')
+      else
+        download_screenshot_set(iphone_urls, download_dir, 'iPhone') unless iphone_urls.empty?
+        download_screenshot_set(ipad_urls, download_dir, 'iPad')     unless ipad_urls.empty?
+      end
+    end
+
+    def download_description(app_info, country)
+      puts "\n📝 Saving app information\n"
+
+      download_dir = create_app_directory(app_info, 'info')
+
+      # Generate detailed text information
+      info_text = generate_app_info_text(app_info)
+
+      # Generate JSON data
+      info_json = generate_app_info_json(app_info)
+
+      # Save as TXT
+      txt_file = File.join(download_dir, "app_info.txt")
+      File.open(txt_file, 'w:UTF-8') { |f| f.write(info_text) }
+
+      # Save as JSON
+      json_file = File.join(download_dir, "app_info.json")
+      File.open(json_file, 'w:UTF-8') { |f| f.write(JSON.pretty_generate(info_json)) }
+
+      # Save as Markdown
+      md_file = File.join(download_dir, "README.md")
+      md_text = generate_app_info_markdown(app_info)
+      File.open(md_file, 'w:UTF-8') { |f| f.write(md_text) }
+
+      puts "✨ App information saved successfully!"
+      puts "📁 Directory: #{download_dir}"
+      puts "   - app_info.txt  (Plain text)"
+      puts "   - app_info.json (JSON format)"
+      puts "   - README.md     (Markdown format)"
+
+      # On macOS, ask whether to open the directory
+      if RUBY_PLATFORM.include?('darwin')
+        print "\nOpen the folder now? (y/n): "
+        response = $stdin.gets.chomp.strip.downcase
+        system("open '#{download_dir}'") if response == 'y'
+      end
+    end
+
+    def download_all(app_info, country)
+      puts "\n📦 Downloading full package (icons + screenshots + app info)\n"
+
+      base_dir = create_app_directory(app_info)
+
+      # 1. Download all icon sizes
+      puts "\n[1/3] 📥 Downloading icons..."
+      icon_dir = File.join(base_dir, 'icons')
+      FileUtils.mkdir_p(icon_dir)
+
+      ICON_SIZES.each do |_key, size_info|
+        artwork_url = app_info[size_info[:key]]
+        next unless artwork_url
+
+        url =
+          if size_info[:display].include?('1024')
+            artwork_url.gsub('512x512', '1024x1024')
+          else
+            artwork_url
+          end
+
+        filename = "icon-#{size_info[:display].split(' ').first}"
+        download_image(url, icon_dir, filename, silent: true)
+      end
+
+      # 2. Download all screenshots
+      puts "\n[2/3] 📥 Downloading screenshots..."
+      screenshot_dir = File.join(base_dir, 'screenshots')
+      FileUtils.mkdir_p(screenshot_dir)
+
+      iphone_urls = app_info['screenshotUrls'] || []
+      ipad_urls   = app_info['ipadScreenshotUrls'] || []
+
+      download_screenshot_set(iphone_urls, screenshot_dir, 'iPhone', silent: true) unless iphone_urls.empty?
+      download_screenshot_set(ipad_urls, screenshot_dir, 'iPad', silent: true)   unless ipad_urls.empty?
+
+      # 3. Save app information
+      puts "\n[3/3] 📥 Saving app information..."
+
+      info_text = generate_app_info_text(app_info)
+      info_json = generate_app_info_json(app_info)
+      info_md   = generate_app_info_markdown(app_info)
+
+      File.open(File.join(base_dir, 'app_info.txt'), 'w:UTF-8')  { |f| f.write(info_text) }
+      File.open(File.join(base_dir, 'app_info.json'), 'w:UTF-8') { |f| f.write(JSON.pretty_generate(info_json)) }
+      File.open(File.join(base_dir, 'README.md'), 'w:UTF-8')    { |f| f.write(info_md) }
+
+      puts "\n✨ Download completed!"
+      puts "📁 All files saved to: #{base_dir}"
+
+      puts "\nDirectory structure:"
+      puts "  ├── icons/           (App icons)"
+      puts "  ├── screenshots/     (App screenshots)"
+      puts "  ├── app_info.txt     (Plain text)"
+      puts "  ├── app_info.json    (JSON format)"
+      puts "  └── README.md        (Markdown)"
+
+      # Statistics
+      files = Dir.glob(File.join(base_dir, '**', '*')).select { |f| File.file?(f) }
+      total_files = files.count
+      total_size  = (files.sum { |f| File.size(f) } / 1024.0 / 1024.0).round(2)
+
+      puts "\n📊 Summary: #{total_files} files, total size #{total_size} MB"
+
+      # On macOS, ask whether to open the directory
+      if RUBY_PLATFORM.include?('darwin')
+        print "\nOpen the folder now? (y/n): "
+        response = $stdin.gets.chomp.strip.downcase
+        system("open '#{base_dir}'") if response == 'y'
+      end
+    end
+
+    def select_icon_size
+      puts "\n📐 Select icon size:\n"
+      ICON_SIZES.each { |key, value| puts "  [#{key}] #{value[:display]}" }
+
+      print "\nSelect (0-3, default: 2): "
+      input = $stdin.gets.chomp.strip
+      input = '2' if input.empty?
+
+      unless ICON_SIZES.key?(input)
+        warn "❌ Invalid selection."
+        return nil
+      end
+
+      ICON_SIZES[input]
+    end
+
+    def download_screenshot_set(urls, base_dir, device_name, silent: false)
+      return if urls.empty?
+
+      puts "\nDownloading #{device_name} screenshots (#{urls.count})..." unless silent
+
+      device_dir = File.join(base_dir, device_name)
+      FileUtils.mkdir_p(device_dir)
+
+      urls.each_with_index do |url, index|
+        filename = "screenshot-#{device_name}-#{index + 1}"
+        download_image(url, device_dir, filename, silent: silent)
+      end
+
+      puts "\n✅ #{device_name} screenshots downloaded" unless silent
+    end
+
+    def download_image(url, dir, basename, silent: false)
+      uri = URI(url)
+
+      URI.open(uri, ssl_verify_mode: OpenSSL::SSL::VERIFY_NONE) do |image|
+        content = image.read
+        ext = detect_image_extension(content)
+
+        filename = File.join(dir, "#{basename}.#{ext}")
+        filename = get_unique_filename(filename)
+
+        File.open(filename, 'wb') { |f| f.write(content) }
+
+        unless silent
+          file_size = (File.size(filename) / 1024.0).round(2)
+          puts "\n✅ Saved: #{File.basename(filename)} (#{file_size} KB)"
+        end
+      end
+    rescue StandardError => e
+      warn "❌ Download failed: #{e.message}" unless silent
+    end
+
+    def generate_app_info_text(app_info)
+      <<~INFO
+    ===================================================
+                    APPLICATION DETAILS
+    ===================================================
+
+    [Basic Information]
+    App Name: #{app_info['trackCensoredName']}
+    App ID: #{app_info['trackId']}
+    Bundle ID: #{app_info['bundleId']}
+    Developer: #{app_info['artistName']}
+    Developer ID: #{app_info['artistId']}
+
+    [Version Information]
+    Current Version: #{app_info['version']}
+    File Size: #{(app_info['fileSizeBytes'].to_i / 1024.0 / 1024.0).round(2)} MB
+    Minimum OS Requirement: iOS #{app_info['minimumOsVersion']}
+    Supported Devices: #{app_info['supportedDevices']&.join(', ') || 'N/A'}
+
+    [Pricing & Ratings]
+    Price: #{app_info['formattedPrice'] || app_info['price']}
+    Currency: #{app_info['currency']}
+    Rating: #{app_info['averageUserRating'] || 'N/A'} (#{app_info['userRatingCount'] || 0} ratings)
+
+    [Categories]
+    Primary Category: #{app_info['primaryGenreName']}
+    All Categories: #{app_info['genres']&.join(', ')}
+
+    [Release Information]
+    First Released: #{app_info['releaseDate']}
+    Last Updated: #{app_info['currentVersionReleaseDate']}
+    Content Rating: #{app_info['contentAdvisoryRating']}
+
+    [Description]
+    #{app_info['description']}
+
+    [Release Notes]
+    #{app_info['releaseNotes'] || 'No release notes provided.'}
+
+    [Developer Information]
+    Developer Website: #{app_info['sellerUrl']}
+
+    [Store Link]
+    App Store: #{app_info['trackViewUrl']}
+
+    ===================================================
+    Exported At: #{Time.now.strftime('%Y-%m-%d %H:%M:%S')}
+    ===================================================
+  INFO
+    end
+
+    def generate_app_info_json(app_info)
+      {
+        basic: {
+          name: app_info['trackCensoredName'],
+          app_id: app_info['trackId'],
+          bundle_id: app_info['bundleId'],
+          developer: app_info['artistName'],
+          developer_id: app_info['artistId']
+        },
+        version: {
+          current_version: app_info['version'],
+          file_size_bytes: app_info['fileSizeBytes'],
+          file_size_mb: (app_info['fileSizeBytes'].to_i / 1024.0 / 1024.0).round(2),
+          minimum_os_version: app_info['minimumOsVersion'],
+          supported_devices: app_info['supportedDevices']
+        },
+        pricing: {
+          price: app_info['price'],
+          formatted_price: app_info['formattedPrice'],
+          currency: app_info['currency']
+        },
+        ratings: {
+          average_rating: app_info['averageUserRating'],
+          rating_count: app_info['userRatingCount'],
+          rating_count_current_version: app_info['userRatingCountForCurrentVersion']
+        },
+        categories: {
+          primary_genre: app_info['primaryGenreName'],
+          all_genres: app_info['genres']
+        },
+        release: {
+          release_date: app_info['releaseDate'],
+          current_version_release_date: app_info['currentVersionReleaseDate'],
+          content_rating: app_info['contentAdvisoryRating']
+        },
+        description: app_info['description'],
+        release_notes: app_info['releaseNotes'],
+        urls: {
+          app_store: app_info['trackViewUrl'],
+          developer_website: app_info['sellerUrl']
+        },
+        screenshots: {
+          iphone: app_info['screenshotUrls'],
+          ipad: app_info['ipadScreenshotUrls']
+        },
+        exported_at: Time.now.iso8601
+      }
+    end
+
+    def generate_app_info_markdown(app_info)
+      <<~MARKDOWN
+    # #{app_info['trackCensoredName']}
+
+    > Developer: #{app_info['artistName']}
+
+    ![Rating](https://img.shields.io/badge/Rating-#{app_info['averageUserRating'] || 'N/A'}-blue)
+    ![Version](https://img.shields.io/badge/Version-#{app_info['version']}-green)
+    ![Price](https://img.shields.io/badge/Price-#{(app_info['formattedPrice'] || app_info['price']).gsub('-', '--')}-orange)
+
+    ## 📱 Basic Information
+
+    | Item | Value |
+    |------|-------|
+    | App ID | #{app_info['trackId']} |
+    | Bundle ID | #{app_info['bundleId']} |
+    | Developer | #{app_info['artistName']} |
+    | Primary Category | #{app_info['primaryGenreName']} |
+    | Content Rating | #{app_info['contentAdvisoryRating']} |
+
+    ## 📊 Version Information
+
+    - **Current Version**: #{app_info['version']}
+    - **File Size**: #{(app_info['fileSizeBytes'].to_i / 1024.0 / 1024.0).round(2)} MB
+    - **Minimum OS**: iOS #{app_info['minimumOsVersion']}
+    - **Release Date**: #{app_info['currentVersionReleaseDate']}
+
+    ## ⭐ Ratings
+
+    - **Average Rating**: #{app_info['averageUserRating'] || 'N/A'} / 5.0
+    - **Total Ratings**: #{app_info['userRatingCount'] || 0}
+
+    ## 📝 Description
+
+    #{app_info['description']}
+
+    ## 🆕 What's New
+
+    #{app_info['releaseNotes'] || 'No release notes provided.'}
+
+    ## 🔗 Links
+
+    - [App Store](#{app_info['trackViewUrl']})
+    - [Developer Website](#{app_info['sellerUrl']})
+
+    ---
+
+    *Exported at: #{Time.now.strftime('%Y-%m-%d %H:%M:%S')}*
+  MARKDOWN
+    end
+
+    def detect_image_extension(content)
+      return 'png' if content[0..7] == "\x89PNG\r\n\x1A\n".b
+      return 'jpg' if content[0..1] == "\xFF\xD8".b
+      return 'gif' if content[0..2] == "GIF".b
+      return 'webp' if content[8..11] == "WEBP".b
+      'jpg'
+    end
+
+    def sanitize_filename(filename)
+      filename.gsub(/[\/\\:*?"<>|]/, '_').strip
+    end
+
+    def create_app_directory(app_info, subdir = nil)
+      app_name = sanitize_filename(app_info['trackCensoredName'])
+
+      desktop = File.join(Dir.home, 'Desktop')
+      if Dir.exist?(desktop)
+        base_dir = File.join(desktop, 'AppCask Downloads', app_name)
+      else
+        base_dir = File.join(Dir.pwd, 'AppCask Downloads', app_name)
+      end
+
+      final_dir = subdir ? File.join(base_dir, subdir) : base_dir
+      FileUtils.mkdir_p(final_dir)
+      final_dir
+    end
+
+    def get_unique_filename(filename)
+      return filename unless File.exist?(filename)
+
+      dir = File.dirname(filename)
+      basename = File.basename(filename, '.*')
+      ext = File.extname(filename)
+
+      counter = 1
+      loop do
+        new_filename = File.join(dir, "#{basename}_#{counter}#{ext}")
+        return new_filename unless File.exist?(new_filename)
+        counter += 1
+      end
+    end
+
+    def valid_index?(index, max)
+      index >= 0 && index < max
+    end
+  end
+end

data/sig/appcask.rbs

@@ -0,0 +1,4 @@
+module Appcask
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: appcask
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Billow Wang
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: AppCask is a CLI tool for downloading App Store icons, screenshots and
+  metadata.
+email:
+- netheadonline@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".idea/workspace.xml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- examples/batch_download.rb
+- lib/appcask.rb
+- lib/appcask/version.rb
+- sig/appcask.rbs
+homepage: https://github.com/gamepunk/appcask
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org/
+  homepage_uri: https://github.com/gamepunk/appcask
+  source_code_uri: https://github.com/gamepunk/appcask
+  changelog_uri: https://github.com/gamepunk/appcask
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Download App Store app assets easily
+test_files: []