appcask 0.4.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.idea/workspace.xml +29 -14
- data/CHANGELOG.md +40 -23
- data/QUICKSTART.md +100 -100
- data/README.md +104 -104
- data/lib/appcask/version.rb +1 -1
- data/sig/appcask.rbs +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 48679d79eff66c3c34e8ee886f5449a6c7919a114fb39472b132f1492cca43c1
|
|
4
|
+
data.tar.gz: 33588e1ff753e1515c8da38da478c201d11462e7419f4f36f36a0e4bfd91f20e
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 95120b0ef5a1aed7f65affdfcbcf1e981e3d1479481edb9550e602ebb2acb8871d49304503f75670128f7a4fb4c507bc90d19ee8c730aab0e7582f6a5829e724
|
|
7
|
+
data.tar.gz: 5752039b68b0257ace847d0487799d28d16a589338e8b2d5ccccc51a8e4c64e0051176b3cf5f372fbb9ecb2164850a5ed1361253e22ebbc44d317f2d21a67dda
|
data/.idea/workspace.xml
CHANGED
|
@@ -4,10 +4,13 @@
|
|
|
4
4
|
<option name="autoReloadType" value="SELECTIVE" />
|
|
5
5
|
</component>
|
|
6
6
|
<component name="ChangeListManager">
|
|
7
|
-
<list default="true" id="1bd4c817-c426-471c-bdf5-e80649db2ae2" name="更改" comment="
|
|
7
|
+
<list default="true" id="1bd4c817-c426-471c-bdf5-e80649db2ae2" name="更改" comment="Release v0.4.0">
|
|
8
8
|
<change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
|
|
9
|
-
<change beforePath="$PROJECT_DIR$/
|
|
9
|
+
<change beforePath="$PROJECT_DIR$/CHANGELOG.md" beforeDir="false" afterPath="$PROJECT_DIR$/CHANGELOG.md" afterDir="false" />
|
|
10
|
+
<change beforePath="$PROJECT_DIR$/QUICKSTART.md" beforeDir="false" afterPath="$PROJECT_DIR$/QUICKSTART.md" afterDir="false" />
|
|
11
|
+
<change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
|
|
10
12
|
<change beforePath="$PROJECT_DIR$/lib/appcask/version.rb" beforeDir="false" afterPath="$PROJECT_DIR$/lib/appcask/version.rb" afterDir="false" />
|
|
13
|
+
<change beforePath="$PROJECT_DIR$/sig/appcask.rbs" beforeDir="false" afterPath="$PROJECT_DIR$/sig/appcask.rbs" afterDir="false" />
|
|
11
14
|
</list>
|
|
12
15
|
<option name="SHOW_DIALOG" value="false" />
|
|
13
16
|
<option name="HIGHLIGHT_CONFLICTS" value="true" />
|
|
@@ -17,18 +20,18 @@
|
|
|
17
20
|
<component name="Git.Settings">
|
|
18
21
|
<option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
|
|
19
22
|
</component>
|
|
20
|
-
<component name="GitHubPullRequestSearchHistory"
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
23
|
+
<component name="GitHubPullRequestSearchHistory">{
|
|
24
|
+
"lastFilter": {
|
|
25
|
+
"state": "OPEN",
|
|
26
|
+
"assignee": "gamepunk"
|
|
24
27
|
}
|
|
25
|
-
}
|
|
26
|
-
<component name="GithubPullRequestsUISettings"
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
28
|
+
}</component>
|
|
29
|
+
<component name="GithubPullRequestsUISettings">{
|
|
30
|
+
"selectedUrlAndAccountId": {
|
|
31
|
+
"url": "git@github.com:gamepunk/appcask.git",
|
|
32
|
+
"accountId": "c65009d6-c05d-4123-9f5d-523285df6f23"
|
|
30
33
|
}
|
|
31
|
-
}
|
|
34
|
+
}</component>
|
|
32
35
|
<component name="ProjectColorInfo">{
|
|
33
36
|
"associatedIndex": 3
|
|
34
37
|
}</component>
|
|
@@ -45,6 +48,7 @@
|
|
|
45
48
|
"RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
|
|
46
49
|
"RunOnceActivity.git.unshallow": "true",
|
|
47
50
|
"RunOnceActivity.typescript.service.memoryLimit.init": "true",
|
|
51
|
+
"SHELLCHECK.PATH": "/Users/billow/Library/Application Support/JetBrains/RubyMine2025.3/plugins/Shell Script/shellcheck",
|
|
48
52
|
"com.intellij.lang.ruby.rbs.tools.collection.workspace.sync.RbsCollectionUpdateProjectActivity#LAST_UPDATE_TIMESTAMP": "1769702888715",
|
|
49
53
|
"git-widget-placeholder": "main",
|
|
50
54
|
"node.js.detected.package.eslint": "true",
|
|
@@ -75,6 +79,8 @@
|
|
|
75
79
|
<workItem from="1767270116395" duration="20000" />
|
|
76
80
|
<workItem from="1769697520161" duration="4958000" />
|
|
77
81
|
<workItem from="1769702829159" duration="2415000" />
|
|
82
|
+
<workItem from="1769709405343" duration="432000" />
|
|
83
|
+
<workItem from="1769754602300" duration="460000" />
|
|
78
84
|
</task>
|
|
79
85
|
<task id="LOCAL-00001" summary="delete gem">
|
|
80
86
|
<option name="closed" value="true" />
|
|
@@ -84,7 +90,15 @@
|
|
|
84
90
|
<option name="project" value="LOCAL" />
|
|
85
91
|
<updated>1769704203657</updated>
|
|
86
92
|
</task>
|
|
87
|
-
<
|
|
93
|
+
<task id="LOCAL-00002" summary="Release v0.4.0">
|
|
94
|
+
<option name="closed" value="true" />
|
|
95
|
+
<created>1769709497761</created>
|
|
96
|
+
<option name="number" value="00002" />
|
|
97
|
+
<option name="presentableId" value="LOCAL-00002" />
|
|
98
|
+
<option name="project" value="LOCAL" />
|
|
99
|
+
<updated>1769709497761</updated>
|
|
100
|
+
</task>
|
|
101
|
+
<option name="localTasksCounter" value="3" />
|
|
88
102
|
<servers />
|
|
89
103
|
</component>
|
|
90
104
|
<component name="TypeScriptGeneratedFilesManager">
|
|
@@ -93,6 +107,7 @@
|
|
|
93
107
|
<component name="VcsManagerConfiguration">
|
|
94
108
|
<MESSAGE value="first commit" />
|
|
95
109
|
<MESSAGE value="delete gem" />
|
|
96
|
-
<
|
|
110
|
+
<MESSAGE value="Release v0.4.0" />
|
|
111
|
+
<option name="LAST_COMMIT_MESSAGE" value="Release v0.4.0" />
|
|
97
112
|
</component>
|
|
98
113
|
</project>
|
data/CHANGELOG.md
CHANGED
|
@@ -4,29 +4,29 @@ All notable changes to this project will be documented in this file.
|
|
|
4
4
|
|
|
5
5
|
## [0.1.0] - 2026-01-29
|
|
6
6
|
|
|
7
|
-
### 🎉
|
|
8
|
-
|
|
9
|
-
#### 🆕
|
|
10
|
-
- ✨
|
|
11
|
-
- 📸
|
|
12
|
-
- 📝
|
|
13
|
-
- 📦
|
|
14
|
-
|
|
15
|
-
#### 📋
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
#### 🌍
|
|
25
|
-
|
|
26
|
-
- 🇹🇼
|
|
27
|
-
- 🇬🇧
|
|
28
|
-
- 🇩🇪
|
|
29
|
-
- 🇫🇷
|
|
7
|
+
### 🎉 Initial Release
|
|
8
|
+
|
|
9
|
+
#### 🆕 Download Modes
|
|
10
|
+
- ✨ **Icon Download** - 4 sizes available (60x60 to 1024x1024)
|
|
11
|
+
- 📸 **Screenshot Download** - Batch download for iPhone and iPad screenshots
|
|
12
|
+
- 📝 **App Info Export** - 3 formats (TXT/JSON/Markdown)
|
|
13
|
+
- 📦 **Full Package Download** - One-click download of all resources
|
|
14
|
+
|
|
15
|
+
#### 📋 App Info Fields
|
|
16
|
+
- Basic Info: Name, ID, Bundle ID, Developer
|
|
17
|
+
- Version Info: Version number, file size, system requirements, supported devices
|
|
18
|
+
- Rating Data: Average rating, number of ratings
|
|
19
|
+
- Price Info: Price, currency
|
|
20
|
+
- Category Info: Primary category, all categories
|
|
21
|
+
- Content Info: App description, version update notes
|
|
22
|
+
- Link Info: App Store link, developer website
|
|
23
|
+
|
|
24
|
+
#### 🌍 More Regions
|
|
25
|
+
New support added for:
|
|
26
|
+
- 🇹🇼 Taiwan (tw)
|
|
27
|
+
- 🇬🇧 United Kingdom (gb)
|
|
28
|
+
- 🇩🇪 Germany (de)
|
|
29
|
+
- 🇫🇷 France (fr)
|
|
30
30
|
|
|
31
31
|
## [0.2.0] - 2026-01-30
|
|
32
32
|
|
|
@@ -34,3 +34,20 @@ All notable changes to this project will be documented in this file.
|
|
|
34
34
|
- Add: improved CLI UX and error messages
|
|
35
35
|
- Add: full app info export (txt/json/markdown)
|
|
36
36
|
- Improve: screenshot & icon download stability
|
|
37
|
+
|
|
38
|
+
## [0.3.0] - 2026-01-30
|
|
39
|
+
|
|
40
|
+
### 🏗️ Refactoring
|
|
41
|
+
- Rename module from `Appcask` to `AppCask` for better naming convention
|
|
42
|
+
- Use `require_relative` instead of `require` for internal dependencies
|
|
43
|
+
|
|
44
|
+
## [0.4.0] - 2026-01-30
|
|
45
|
+
|
|
46
|
+
### 🔒 Security
|
|
47
|
+
- Add SSL certificate verification (`OpenSSL::SSL::VERIFY_PEER`)
|
|
48
|
+
|
|
49
|
+
### 🎨 UI Improvements
|
|
50
|
+
- Fix region selection display format (one region per line for better readability)
|
|
51
|
+
|
|
52
|
+
### 📚 Documentation
|
|
53
|
+
- Update Ruby version requirement in README
|
data/QUICKSTART.md
CHANGED
|
@@ -1,140 +1,140 @@
|
|
|
1
|
-
# AppCask
|
|
1
|
+
# AppCask Quick Start Guide
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## 🎉 Welcome to AppCask!
|
|
4
4
|
|
|
5
|
-
AppCask
|
|
5
|
+
AppCask is a powerful command-line tool that helps you download various resources from App Store applications.
|
|
6
6
|
|
|
7
|
-
## 5
|
|
7
|
+
## Get Started in 5 Minutes
|
|
8
8
|
|
|
9
|
-
### 1️⃣
|
|
9
|
+
### 1️⃣ Installation
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
12
|
gem install appcask
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
### 2️⃣
|
|
15
|
+
### 2️⃣ First Time Use
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
The simplest way - just run:
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
appcask
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
Then follow the prompts!
|
|
24
24
|
|
|
25
|
-
### 3️⃣
|
|
25
|
+
### 3️⃣ Quick Search
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
If you know what app you're looking for:
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
30
|
appcask "Instagram"
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
-
### 4️⃣
|
|
33
|
+
### 4️⃣ Select Download Content
|
|
34
34
|
|
|
35
|
-
|
|
35
|
+
After running, you'll see 4 options:
|
|
36
36
|
|
|
37
37
|
```
|
|
38
|
-
[1]
|
|
39
|
-
[2]
|
|
40
|
-
[3]
|
|
41
|
-
[4]
|
|
38
|
+
[1] Icons - Download app icons (4 sizes)
|
|
39
|
+
[2] Screenshots - Download app screenshots (iPhone and iPad)
|
|
40
|
+
[3] App Info - Export detailed app information
|
|
41
|
+
[4] Full Package - Download everything at once
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
We recommend beginners choose **[4] Full Package** to get all resources in one go!
|
|
45
45
|
|
|
46
|
-
##
|
|
46
|
+
## Common Use Cases
|
|
47
47
|
|
|
48
|
-
###
|
|
48
|
+
### Scenario 1: I want high-resolution app icons
|
|
49
49
|
|
|
50
50
|
```bash
|
|
51
|
-
appcask "
|
|
52
|
-
#
|
|
53
|
-
#
|
|
51
|
+
appcask "App Name"
|
|
52
|
+
# Select [1] Icons
|
|
53
|
+
# Select [3] 1024x1024
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
###
|
|
56
|
+
### Scenario 2: I need all screenshots of the app
|
|
57
57
|
|
|
58
58
|
```bash
|
|
59
|
-
appcask "
|
|
60
|
-
#
|
|
61
|
-
#
|
|
59
|
+
appcask "App Name"
|
|
60
|
+
# Select [2] Screenshots
|
|
61
|
+
# Select all (download screenshots for all devices)
|
|
62
62
|
```
|
|
63
63
|
|
|
64
|
-
###
|
|
64
|
+
### Scenario 3: I need detailed info for app analysis
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
|
-
appcask "
|
|
68
|
-
#
|
|
69
|
-
#
|
|
67
|
+
appcask "App Name"
|
|
68
|
+
# Select [3] App Info
|
|
69
|
+
# Generates 3 files: TXT, JSON, Markdown
|
|
70
70
|
```
|
|
71
71
|
|
|
72
|
-
###
|
|
72
|
+
### Scenario 4: I want everything!
|
|
73
73
|
|
|
74
74
|
```bash
|
|
75
|
-
appcask "
|
|
76
|
-
#
|
|
77
|
-
#
|
|
75
|
+
appcask "App Name"
|
|
76
|
+
# Select [4] Full Package
|
|
77
|
+
# Download icons, screenshots, and info in one go
|
|
78
78
|
```
|
|
79
79
|
|
|
80
|
-
##
|
|
80
|
+
## Where Are Downloaded Files Saved?
|
|
81
81
|
|
|
82
|
-
|
|
82
|
+
Default save location:
|
|
83
83
|
|
|
84
84
|
```
|
|
85
|
-
~/Desktop/AppCask Downloads
|
|
85
|
+
~/Desktop/AppCask Downloads/App Name/
|
|
86
86
|
```
|
|
87
87
|
|
|
88
|
-
|
|
88
|
+
Directory structure:
|
|
89
89
|
|
|
90
90
|
```
|
|
91
91
|
Instagram/
|
|
92
|
-
├── icons/ #
|
|
93
|
-
├── screenshots/ #
|
|
92
|
+
├── icons/ # Icons in all sizes
|
|
93
|
+
├── screenshots/ # Screenshots organized by device
|
|
94
94
|
│ ├── iPhone/
|
|
95
95
|
│ └── iPad/
|
|
96
|
-
├── app_info.txt #
|
|
97
|
-
├── app_info.json # JSON
|
|
98
|
-
└── README.md # Markdown
|
|
96
|
+
├── app_info.txt # Text format info
|
|
97
|
+
├── app_info.json # JSON format info
|
|
98
|
+
└── README.md # Markdown format documentation
|
|
99
99
|
```
|
|
100
100
|
|
|
101
|
-
##
|
|
101
|
+
## Search App Stores in Other Countries
|
|
102
102
|
|
|
103
|
-
AppCask
|
|
103
|
+
AppCask supports 9 countries/regions:
|
|
104
104
|
|
|
105
105
|
```bash
|
|
106
|
-
#
|
|
107
|
-
appcask "
|
|
106
|
+
# Search China region
|
|
107
|
+
appcask "WeChat" cn
|
|
108
108
|
|
|
109
|
-
#
|
|
109
|
+
# Search Japan region
|
|
110
110
|
appcask "Line" jp
|
|
111
111
|
|
|
112
|
-
#
|
|
112
|
+
# Search Korea region
|
|
113
113
|
appcask "KakaoTalk" kr
|
|
114
114
|
```
|
|
115
115
|
|
|
116
|
-
|
|
117
|
-
- `us` - 🇺🇸
|
|
118
|
-
- `cn` - 🇨🇳
|
|
119
|
-
- `jp` - 🇯🇵
|
|
120
|
-
- `kr` - 🇰🇷
|
|
121
|
-
- `hk` - 🇭🇰
|
|
122
|
-
- `tw` - 🇹🇼
|
|
123
|
-
- `gb` - 🇬🇧
|
|
124
|
-
- `de` - 🇩🇪
|
|
125
|
-
- `fr` - 🇫🇷
|
|
116
|
+
Supported region codes:
|
|
117
|
+
- `us` - 🇺🇸 United States
|
|
118
|
+
- `cn` - 🇨🇳 China
|
|
119
|
+
- `jp` - 🇯🇵 Japan
|
|
120
|
+
- `kr` - 🇰🇷 Korea
|
|
121
|
+
- `hk` - 🇭🇰 Hong Kong
|
|
122
|
+
- `tw` - 🇹🇼 Taiwan
|
|
123
|
+
- `gb` - 🇬🇧 United Kingdom
|
|
124
|
+
- `de` - 🇩🇪 Germany
|
|
125
|
+
- `fr` - 🇫🇷 France
|
|
126
126
|
|
|
127
|
-
##
|
|
127
|
+
## Shortcuts
|
|
128
128
|
|
|
129
|
-
-
|
|
130
|
-
- **q** -
|
|
131
|
-
- **Ctrl+C** -
|
|
129
|
+
- **Enter** - Use default option
|
|
130
|
+
- **q** - Exit current step
|
|
131
|
+
- **Ctrl+C** - Safely exit the program
|
|
132
132
|
|
|
133
|
-
##
|
|
133
|
+
## Useful Tips
|
|
134
134
|
|
|
135
|
-
###
|
|
135
|
+
### Tip 1: Batch Download
|
|
136
136
|
|
|
137
|
-
|
|
137
|
+
Create a text file `apps.txt`:
|
|
138
138
|
|
|
139
139
|
```
|
|
140
140
|
Instagram
|
|
@@ -143,7 +143,7 @@ Facebook
|
|
|
143
143
|
TikTok
|
|
144
144
|
```
|
|
145
145
|
|
|
146
|
-
|
|
146
|
+
Then run:
|
|
147
147
|
|
|
148
148
|
```bash
|
|
149
149
|
while read app; do
|
|
@@ -152,73 +152,73 @@ while read app; do
|
|
|
152
152
|
done < apps.txt
|
|
153
153
|
```
|
|
154
154
|
|
|
155
|
-
###
|
|
155
|
+
### Tip 2: Preview Only, No Download
|
|
156
156
|
|
|
157
|
-
|
|
157
|
+
Want to see what information is available without downloading? Press `q` to exit anytime!
|
|
158
158
|
|
|
159
|
-
###
|
|
159
|
+
### Tip 3: macOS Exclusive
|
|
160
160
|
|
|
161
|
-
|
|
161
|
+
After download completes, select `y` to open the folder directly:
|
|
162
162
|
|
|
163
163
|
```
|
|
164
|
-
|
|
164
|
+
Open folder? (y/n): y
|
|
165
165
|
```
|
|
166
166
|
|
|
167
|
-
##
|
|
167
|
+
## Having Issues?
|
|
168
168
|
|
|
169
|
-
###
|
|
169
|
+
### Issue 1: Can't find the app
|
|
170
170
|
|
|
171
|
-
✅
|
|
172
|
-
-
|
|
173
|
-
-
|
|
174
|
-
-
|
|
171
|
+
✅ Solutions:
|
|
172
|
+
- Check spelling
|
|
173
|
+
- Try searching with the English name
|
|
174
|
+
- Switch to different regions
|
|
175
175
|
|
|
176
|
-
###
|
|
176
|
+
### Issue 2: Network timeout
|
|
177
177
|
|
|
178
|
-
✅
|
|
179
|
-
-
|
|
180
|
-
-
|
|
181
|
-
-
|
|
178
|
+
✅ Solutions:
|
|
179
|
+
- Check network connection
|
|
180
|
+
- Use VPN
|
|
181
|
+
- Try again later
|
|
182
182
|
|
|
183
|
-
###
|
|
183
|
+
### Issue 3: Download failed
|
|
184
184
|
|
|
185
|
-
✅
|
|
185
|
+
✅ Solutions:
|
|
186
186
|
|
|
187
187
|
```bash
|
|
188
|
-
DEBUG=1 appcask "
|
|
188
|
+
DEBUG=1 appcask "App Name"
|
|
189
189
|
```
|
|
190
190
|
|
|
191
|
-
|
|
191
|
+
This will display detailed error messages for troubleshooting.
|
|
192
192
|
|
|
193
|
-
##
|
|
193
|
+
## What's Next?
|
|
194
194
|
|
|
195
|
-
###
|
|
195
|
+
### Learn More Features
|
|
196
196
|
|
|
197
|
-
|
|
197
|
+
Check full documentation:
|
|
198
198
|
|
|
199
199
|
```bash
|
|
200
|
-
#
|
|
200
|
+
# If you have the gem installed
|
|
201
201
|
gem help appcask
|
|
202
202
|
```
|
|
203
203
|
|
|
204
|
-
|
|
204
|
+
Or visit the GitHub repository to view README.md
|
|
205
205
|
|
|
206
|
-
###
|
|
206
|
+
### Upgrade to Latest Version
|
|
207
207
|
|
|
208
208
|
```bash
|
|
209
209
|
gem update appcask
|
|
210
210
|
```
|
|
211
211
|
|
|
212
|
-
###
|
|
212
|
+
### Share Your Experience
|
|
213
213
|
|
|
214
|
-
|
|
214
|
+
⭐ Find it helpful? Give the project a Star
|
|
215
215
|
|
|
216
|
-
|
|
216
|
+
📝 Have questions? Submit an Issue
|
|
217
217
|
|
|
218
|
-
|
|
218
|
+
🚀Have suggestions? Open a Pull Request
|
|
219
219
|
|
|
220
|
-
##
|
|
220
|
+
## Lastly
|
|
221
221
|
|
|
222
|
-
|
|
222
|
+
Enjoy using AppCask! If you have any questions, feedback is always welcome.
|
|
223
223
|
|
|
224
|
-
Happy downloading!
|
|
224
|
+
🎊 Happy downloading!
|
data/README.md
CHANGED
|
@@ -1,73 +1,73 @@
|
|
|
1
|
-
# AppCask - App Store
|
|
1
|
+
# AppCask - App Store Resources Downloader
|
|
2
2
|
|
|
3
3
|
<div align="center">
|
|
4
4
|
|
|
5
|
-

|
|
6
6
|

|
|
7
7
|

|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
9
|
+
An all-in-one command-line tool for downloading resources of iOS App Store apps
|
|
10
|
+
**Icons • Screenshots • App Description • One-click Packaging**
|
|
11
11
|
|
|
12
|
-
[
|
|
12
|
+
[Features](#-features) • [Installation](#-installation) • [Usage Guide](#-usage-guide) • [Examples](#-usage-examples)
|
|
13
13
|
|
|
14
14
|
</div>
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
18
|
-
## ✨
|
|
19
|
-
|
|
20
|
-
### 🎨
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
|
|
25
|
-
### 📸
|
|
26
|
-
- iPhone
|
|
27
|
-
- iPad
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
|
|
31
|
-
### 📝
|
|
32
|
-
- **TXT
|
|
33
|
-
- **JSON
|
|
34
|
-
- **Markdown
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
|
|
45
|
-
### 📦
|
|
46
|
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
|
|
51
|
-
### 🌍
|
|
52
|
-
- 🇺🇸
|
|
53
|
-
- 🇨🇳
|
|
54
|
-
- 🇯🇵
|
|
55
|
-
- 🇰🇷
|
|
56
|
-
- 🇭🇰
|
|
57
|
-
- 🇹🇼
|
|
58
|
-
- 🇬🇧
|
|
59
|
-
- 🇩🇪
|
|
60
|
-
- 🇫🇷
|
|
18
|
+
## ✨ Features
|
|
19
|
+
|
|
20
|
+
### 🎨 Icon Download
|
|
21
|
+
- Supports four sizes: 60x60, 100x100, 512x512, 1024x1024
|
|
22
|
+
- Auto-detect image formats (PNG/JPG/GIF/WEBP)
|
|
23
|
+
- Intelligent file naming
|
|
24
|
+
|
|
25
|
+
### 📸 Screenshot Download
|
|
26
|
+
- iPhone screenshots
|
|
27
|
+
- iPad screenshots
|
|
28
|
+
- Batch download all screenshots
|
|
29
|
+
- Automatic organization and saving
|
|
30
|
+
|
|
31
|
+
### 📝 Export App Information
|
|
32
|
+
- **TXT format** - Human-readable text
|
|
33
|
+
- **JSON format** - Structured data
|
|
34
|
+
- **Markdown format** - Elegant documentation
|
|
35
|
+
|
|
36
|
+
Included information:
|
|
37
|
+
- Basic information (name, developer, Bundle ID)
|
|
38
|
+
- Version information (current version, file size, system requirements)
|
|
39
|
+
- Rating statistics (average rating, number of ratings)
|
|
40
|
+
- Pricing information
|
|
41
|
+
- App description
|
|
42
|
+
- Version update notes
|
|
43
|
+
- Related links
|
|
44
|
+
|
|
45
|
+
### 📦 One-click Full Package
|
|
46
|
+
Download all resources for the app, including:
|
|
47
|
+
- Icons in all sizes
|
|
48
|
+
- Screenshots for all devices
|
|
49
|
+
- Complete app information (in 3 formats)
|
|
50
|
+
|
|
51
|
+
### 🌍 Multiregion Support
|
|
52
|
+
- 🇺🇸 United States (US)
|
|
53
|
+
- 🇨🇳 China (CN)
|
|
54
|
+
- 🇯🇵 Japan (JP)
|
|
55
|
+
- 🇰🇷 Korea (KR)
|
|
56
|
+
- 🇭🇰 Hong Kong (HK)
|
|
57
|
+
- 🇹🇼 Taiwan (TW)
|
|
58
|
+
- 🇬🇧 United Kingdom (GB)
|
|
59
|
+
- 🇩🇪 Germany (DE)
|
|
60
|
+
- 🇫🇷 France (FR)
|
|
61
61
|
|
|
62
62
|
---
|
|
63
63
|
|
|
64
|
-
## 📦
|
|
64
|
+
## 📦 Installation
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
67
|
gem install appcask
|
|
68
68
|
```
|
|
69
69
|
|
|
70
|
-
|
|
70
|
+
Or from source:
|
|
71
71
|
|
|
72
72
|
```bash
|
|
73
73
|
git clone https://github.com/yourusername/appcask.git
|
|
@@ -79,81 +79,81 @@ gem install pkg/appcask-1.0.0.gem
|
|
|
79
79
|
|
|
80
80
|
---
|
|
81
81
|
|
|
82
|
-
## 🚀
|
|
82
|
+
## 🚀 Quick Start
|
|
83
83
|
|
|
84
84
|
```bash
|
|
85
|
-
#
|
|
85
|
+
# Interactive mode
|
|
86
86
|
appcask
|
|
87
87
|
|
|
88
|
-
#
|
|
88
|
+
# Quick search
|
|
89
89
|
appcask "Instagram"
|
|
90
90
|
|
|
91
|
-
#
|
|
92
|
-
appcask "
|
|
91
|
+
# Specify region
|
|
92
|
+
appcask "WeChat" cn
|
|
93
93
|
```
|
|
94
94
|
|
|
95
|
-
###
|
|
95
|
+
### Full Demo
|
|
96
96
|
|
|
97
97
|
```
|
|
98
98
|
$ appcask "Twitter"
|
|
99
99
|
|
|
100
100
|
╔═══════════════════════════════════════════╗
|
|
101
|
-
║ AppCask - App
|
|
101
|
+
║ AppCask - App Resources Downloader ║
|
|
102
102
|
║ v1.0.0 ║
|
|
103
103
|
╚═══════════════════════════════════════════╝
|
|
104
104
|
|
|
105
|
-
🔍
|
|
105
|
+
🔍 Searching for "Twitter"...
|
|
106
106
|
|
|
107
|
-
📋
|
|
107
|
+
📋 Found 3 results:
|
|
108
108
|
|
|
109
109
|
[0] X
|
|
110
|
-
|
|
111
|
-
|
|
110
|
+
Developer: X Corp. | Version: 10.31
|
|
111
|
+
Price: Free | Rating: ⭐ 4.2
|
|
112
112
|
|
|
113
|
-
|
|
113
|
+
Please choose (0-2, or press q to quit): 0
|
|
114
114
|
|
|
115
|
-
✅
|
|
115
|
+
✅ Selected: X
|
|
116
116
|
|
|
117
|
-
📦
|
|
118
|
-
[1]
|
|
119
|
-
[2]
|
|
120
|
-
[3]
|
|
121
|
-
[4]
|
|
117
|
+
📦 Choose content to download:
|
|
118
|
+
[1] Icon
|
|
119
|
+
[2] Screenshots
|
|
120
|
+
[3] Description
|
|
121
|
+
[4] Full package (Icons + Screenshots + Description)
|
|
122
122
|
|
|
123
|
-
|
|
123
|
+
Please choose (1-4): 4
|
|
124
124
|
|
|
125
|
-
✨
|
|
125
|
+
✨ Download complete!
|
|
126
126
|
📁 ~/Desktop/AppCask Downloads/X
|
|
127
|
-
📊
|
|
127
|
+
📊 Stats: 15 files, total size 8.45 MB
|
|
128
128
|
```
|
|
129
129
|
|
|
130
130
|
---
|
|
131
131
|
|
|
132
|
-
## 📖
|
|
132
|
+
## 📖 Usage Examples
|
|
133
133
|
|
|
134
|
-
###
|
|
134
|
+
### Download Only Icons
|
|
135
135
|
|
|
136
136
|
```bash
|
|
137
137
|
appcask "Instagram"
|
|
138
|
-
#
|
|
138
|
+
# Choose: [1] Icons → [3] 1024x1024
|
|
139
139
|
```
|
|
140
140
|
|
|
141
|
-
###
|
|
141
|
+
### Download All Screenshots
|
|
142
142
|
|
|
143
143
|
```bash
|
|
144
|
-
appcask "
|
|
145
|
-
#
|
|
144
|
+
appcask "Honor of Kings" cn
|
|
145
|
+
# Choose: [2] Screenshots → all
|
|
146
146
|
```
|
|
147
147
|
|
|
148
|
-
###
|
|
148
|
+
### Export App Information
|
|
149
149
|
|
|
150
150
|
```bash
|
|
151
151
|
appcask "Notion"
|
|
152
|
-
#
|
|
153
|
-
#
|
|
152
|
+
# Choose: [3] Description
|
|
153
|
+
# Output: TXT + JSON + Markdown
|
|
154
154
|
```
|
|
155
155
|
|
|
156
|
-
###
|
|
156
|
+
### Batch Download
|
|
157
157
|
|
|
158
158
|
```ruby
|
|
159
159
|
#!/usr/bin/env ruby
|
|
@@ -168,7 +168,7 @@ end
|
|
|
168
168
|
|
|
169
169
|
---
|
|
170
170
|
|
|
171
|
-
## 📂
|
|
171
|
+
## 📂 File Structure
|
|
172
172
|
|
|
173
173
|
```
|
|
174
174
|
AppCask Downloads/
|
|
@@ -188,57 +188,57 @@ AppCask Downloads/
|
|
|
188
188
|
|
|
189
189
|
---
|
|
190
190
|
|
|
191
|
-
## 🔧
|
|
191
|
+
## 🔧 Advanced Features
|
|
192
192
|
|
|
193
|
-
### Debug
|
|
193
|
+
### Debug Mode
|
|
194
194
|
|
|
195
195
|
```bash
|
|
196
196
|
DEBUG=1 appcask "AppName"
|
|
197
197
|
```
|
|
198
198
|
|
|
199
|
-
###
|
|
199
|
+
### Quick Operations
|
|
200
200
|
|
|
201
|
-
-
|
|
202
|
-
- **q** -
|
|
203
|
-
- **Ctrl+C** -
|
|
201
|
+
- **Enter** - Default option
|
|
202
|
+
- **q** - Quit
|
|
203
|
+
- **Ctrl+C** - Interrupt
|
|
204
204
|
|
|
205
205
|
---
|
|
206
206
|
|
|
207
|
-
## 🐛
|
|
207
|
+
## 🐛 Troubleshooting
|
|
208
208
|
|
|
209
|
-
**Q:
|
|
210
|
-
A:
|
|
209
|
+
**Q: Can't find the app?**
|
|
210
|
+
A: Check spelling and try switching regions
|
|
211
211
|
|
|
212
|
-
**Q:
|
|
213
|
-
A:
|
|
212
|
+
**Q: Icon size is wrong?**
|
|
213
|
+
A: Some apps do not support 1024x1024
|
|
214
214
|
|
|
215
|
-
**Q:
|
|
216
|
-
A:
|
|
215
|
+
**Q: Network timeout?**
|
|
216
|
+
A: Check network, use VPN
|
|
217
217
|
|
|
218
|
-
**Q:
|
|
218
|
+
**Q: Where are files saved?**
|
|
219
219
|
A: `~/Desktop/AppCask Downloads/`
|
|
220
220
|
|
|
221
221
|
---
|
|
222
222
|
|
|
223
|
-
## 🎯
|
|
223
|
+
## 🎯 Roadmap
|
|
224
224
|
|
|
225
|
-
- [ ] macOS App Store
|
|
226
|
-
- [ ]
|
|
227
|
-
- [ ]
|
|
228
|
-
- [ ] Web
|
|
225
|
+
- [ ] macOS App Store support
|
|
226
|
+
- [ ] App reviews download
|
|
227
|
+
- [ ] Batch download mode
|
|
228
|
+
- [ ] Web interface
|
|
229
229
|
|
|
230
230
|
---
|
|
231
231
|
|
|
232
|
-
## 📄
|
|
232
|
+
## 📄 License
|
|
233
233
|
|
|
234
234
|
MIT License
|
|
235
235
|
|
|
236
236
|
---
|
|
237
237
|
|
|
238
|
-
## 📮
|
|
238
|
+
## 📮 Contact
|
|
239
239
|
|
|
240
240
|
- GitHub: [@yourusername](https://github.com/yourusername)
|
|
241
|
-
- Issues: [
|
|
241
|
+
- Issues: [Feedback issues](https://github.com/yourusername/appcask/issues)
|
|
242
242
|
|
|
243
243
|
---
|
|
244
244
|
|
data/lib/appcask/version.rb
CHANGED
data/sig/appcask.rbs
CHANGED