Skip to content

Commit aa4ad9d

Browse files
author
T-Space Scan Builder
committed
Prepare public one-file release
1 parent 4e4899e commit aa4ad9d

14 files changed

Lines changed: 232 additions & 17 deletions
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
name: Bug report
2+
description: Report a crash, incorrect result, or UI problem.
3+
title: "[Bug]: "
4+
labels: ["bug"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for helping improve Tscan License. Do not attach private company reports, license keys, or secrets.
10+
- type: input
11+
id: version
12+
attributes:
13+
label: Version
14+
description: Example: v0.2.0-beta
15+
validations:
16+
required: true
17+
- type: input
18+
id: windows
19+
attributes:
20+
label: Windows version
21+
description: Example: Windows 11 23H2
22+
validations:
23+
required: true
24+
- type: textarea
25+
id: problem
26+
attributes:
27+
label: What happened?
28+
description: Describe the issue and what you expected.
29+
validations:
30+
required: true
31+
- type: textarea
32+
id: steps
33+
attributes:
34+
label: Steps to reproduce
35+
description: List the exact steps, if possible.
36+
placeholder: |
37+
1. Open TscanLicense.exe
38+
2. Click Scan
39+
3. ...
40+
validations:
41+
required: true
42+
- type: textarea
43+
id: logs
44+
attributes:
45+
label: Relevant logs
46+
description: Paste only non-sensitive lines from %LOCALAPPDATA%\T-SpaceScan\logs\tspace_scan.log.
47+
render: text
48+
validations:
49+
required: false
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: Feature request
2+
description: Suggest a product improvement or scanner rule.
3+
title: "[Feature]: "
4+
labels: ["enhancement"]
5+
body:
6+
- type: textarea
7+
id: need
8+
attributes:
9+
label: What problem should this solve?
10+
description: Explain the workflow or scanner gap.
11+
validations:
12+
required: true
13+
- type: textarea
14+
id: proposal
15+
attributes:
16+
label: Proposed solution
17+
description: Describe the feature, rule, or UI improvement.
18+
validations:
19+
required: true
20+
- type: dropdown
21+
id: area
22+
attributes:
23+
label: Area
24+
options:
25+
- Scanner
26+
- License classifier
27+
- Risk analyzer
28+
- Reports
29+
- UI/UX
30+
- Packaging
31+
- Documentation
32+
- Other
33+
validations:
34+
required: true

.github/workflows/build-windows.yml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,13 @@ jobs:
2929
3030
- name: Build executable
3131
run: |
32-
pyinstaller --clean --noconfirm --onefile --windowed --name TSpaceScan --paths src --add-data "data\license_rules.json;data" run_app.py
33-
Get-FileHash -Algorithm SHA256 .\dist\TSpaceScan.exe | Tee-Object -FilePath .\dist\TSpaceScan.exe.sha256.txt
32+
pyinstaller --clean --noconfirm --onefile --windowed --name TscanLicense --paths src --add-data "data\license_rules.json;data" run_app.py
33+
Get-FileHash -Algorithm SHA256 .\dist\TscanLicense.exe | Tee-Object -FilePath .\dist\TscanLicense.exe.sha256.txt
3434
3535
- name: Upload artifact
3636
uses: actions/upload-artifact@v4
3737
with:
38-
name: TSpaceScan-windows
38+
name: TscanLicense-windows
3939
path: |
40-
dist/TSpaceScan.exe
41-
dist/TSpaceScan.exe.sha256.txt
40+
dist/TscanLicense.exe
41+
dist/TscanLicense.exe.sha256.txt

CHANGELOG.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,9 @@
22

33
## 0.2.0-beta
44

5+
- Added `TscanLicense.exe` as the main portable one-file download name for normal users.
6+
- Added installer packaging through Inno Setup.
7+
- Added privacy, disclaimer, release notes, and GitHub issue templates for public beta use.
58
- Added professional dashboard layout with metrics, charts, filters, history, compare, settings, and detail panel.
69
- Added app grouping: license review, work apps, free/open-source, freemium, developer/runtime, driver/hardware, system/helper, unknown.
710
- Added license priority labels: Review, Review now, No action, Track terms, Inventory, Identify.

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributing
22

3-
Thanks for helping improve T-Space Scan.
3+
Thanks for helping improve Tscan License.
44

55
## Development Setup
66

DISCLAIMER.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Disclaimer
2+
3+
Tscan License helps with installed-software inventory and license-compliance risk review. It is not a legal opinion, procurement system, vendor entitlement portal, or proof of unauthorized software.
4+
5+
## What Findings Mean
6+
7+
Risk findings are signals. A finding can be caused by missing metadata, unusual file names, unsigned executables, old installers, internal packaging, or incomplete local evidence.
8+
9+
Before taking action, verify license status with:
10+
11+
- Vendor account or admin portal
12+
- Purchase records
13+
- Contracts and subscriptions
14+
- Internal software asset management records
15+
- The official publisher website
16+
17+
## What The Tool Does Not Do
18+
19+
The project must not be used to:
20+
21+
- Crack software
22+
- Generate license keys
23+
- Bypass activation
24+
- Patch commercial software
25+
- Hide unauthorized software
26+
- Remove evidence of license violations
27+
- Collect private license keys
28+
29+
## Responsibility
30+
31+
Users and organizations are responsible for validating results and complying with applicable software license terms, contracts, and laws.

PRIVACY.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Privacy
2+
3+
Tscan License is designed as a local-first Windows desktop tool.
4+
5+
## Default Behavior
6+
7+
- The app does not upload telemetry by default.
8+
- The app does not send scan reports to the developer by default.
9+
- The app does not collect or store software license keys.
10+
- Scan history, settings, logs, and the local SQLite database are stored on the user's computer.
11+
12+
Default local data location:
13+
14+
```text
15+
%LOCALAPPDATA%\T-SpaceScan\
16+
```
17+
18+
## Data The App May Display Or Export
19+
20+
When a user scans a computer or exports a report, the data may include:
21+
22+
- Computer and user metadata available to the local Windows account
23+
- Installed software names
24+
- Publishers and versions
25+
- Install paths and executable paths
26+
- Digital signature metadata
27+
- License classification results
28+
- Risk indicators and recommendations
29+
30+
Exported reports should be treated as internal IT/security documents because they may reveal installed software, folder paths, and business tooling.
31+
32+
## Network Access
33+
34+
Current beta builds do not require network access for scanning. Future optional integrations, such as vulnerability lookup or reputation services, should require explicit user/admin configuration.
35+
36+
## Enterprise Use
37+
38+
IT administrators should inform users before collecting software inventory from company devices. If reports are centralized in the future, the transport, retention policy, and access control should be documented clearly before deployment.

README.md

Lines changed: 22 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,23 @@
11
# Tscan License
22

3-
Windows desktop beta for installed-software inventory, license classification, and license-compliance risk signaling.
3+
Free Windows software license scanner for installed-software inventory, software asset management, license classification, and license-compliance risk signaling.
44

55
Tscan License helps IT admins inventory Windows software, separate free/open-source/runtime/driver components from license-review applications, and export reports for software asset management.
66

7-
Download beta builds from [GitHub Releases](https://github.com/hntngoctu1/Tscan_license/releases).
7+
Download the one-file portable app or installer from [GitHub Releases](https://github.com/hntngoctu1/Tscan_license/releases).
8+
9+
## Download For Normal Users
10+
11+
Use this option if you only want to run the app:
12+
13+
1. Open [GitHub Releases](https://github.com/hntngoctu1/Tscan_license/releases/latest).
14+
2. Download `TscanLicense.exe`.
15+
3. Double-click `TscanLicense.exe`.
16+
4. Press **Scan**.
17+
18+
No Python, terminal, or setup step is required. The app stores its local database and logs under `%LOCALAPPDATA%\T-SpaceScan\`.
19+
20+
Alternative: download `TscanLicenseSetup.exe` if you want a Start Menu shortcut and Windows uninstaller.
821

922
> Beta notice: findings are risk indicators, not proof of unauthorized software. Always verify license status with vendor portals, procurement records, contracts, or internal entitlement systems.
1023
@@ -29,7 +42,7 @@ The scanner reports signals, not proof of piracy. It intentionally does not crac
2942
For normal users, download from [GitHub Releases](https://github.com/hntngoctu1/Tscan_license/releases):
3043

3144
- `TscanLicenseSetup.exe`: recommended installer with Start Menu shortcut and uninstaller.
32-
- `TSpaceScan.exe`: portable single-file app, no installation required.
45+
- `TscanLicense.exe`: portable single-file app, no installation required.
3346

3447
Then double-click the downloaded file and press **Scan**.
3548

@@ -97,7 +110,7 @@ Build the Windows executable:
97110
The built file is:
98111

99112
```text
100-
dist\TSpaceScan.exe
113+
dist\TscanLicense.exe
101114
```
102115

103116
If Inno Setup is installed, the build script also creates:
@@ -114,10 +127,14 @@ Recommended deployment options:
114127

115128
- Small team: send the GitHub Release link and ask users to install `TscanLicenseSetup.exe`.
116129
- IT-managed PCs: deploy the installer with Intune, GPO, PDQ Deploy, SCCM, or RMM.
117-
- Portable audit: run `TSpaceScan.exe` from a shared IT folder.
130+
- Portable audit: run `TscanLicense.exe` from a shared IT folder.
118131

119132
The current beta is not code-signed, so Windows SmartScreen may show a warning on first run.
120133

134+
## Search Keywords
135+
136+
Tscan License is relevant for people searching for a Windows software license scanner, software license audit tool, software asset management scanner, installed software inventory tool, license compliance checker, license risk scanner, phần mềm quét bản quyền, kiểm kê phần mềm Windows, quản lý bản quyền phần mềm, and công cụ kiểm tra rủi ro license.
137+
121138
## Privacy And Safety
122139

123140
- No telemetry is uploaded by default.

SECURITY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Scope
44

5-
T-Space Scan is a local Windows software inventory and license-risk scanner. It is designed to collect installed-software metadata and risk indicators for IT/software asset management.
5+
Tscan License is a local Windows software inventory and license-risk scanner. It is designed to collect installed-software metadata and risk indicators for IT/software asset management.
66

77
The tool must not be used to crack, bypass, patch, remove activation, harvest license keys, or hide unauthorized software.
88

docs/RELEASE_NOTES_v0.2.0-beta.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Tscan License v0.2.0-beta
2+
3+
Free Windows software license scanner for installed-software inventory, software asset management, and license-compliance risk review.
4+
5+
## Download
6+
7+
- `TscanLicense.exe` - portable one-file app. Download and double-click to run.
8+
- `TscanLicenseSetup.exe` - optional installer with Start Menu shortcut and uninstaller.
9+
10+
No Python or terminal is required for normal users.
11+
12+
## Highlights
13+
14+
- Installed software inventory from Windows Registry, Program Files, AppData, and Start Menu shortcuts.
15+
- License classification for free, open-source, freemium, trial, paid, subscription, and unknown software.
16+
- Risk score from 0 to 100 with explainable findings.
17+
- Digital signature checks for executable files.
18+
- Dashboard, filters, scan history, comparison, details panel, dark mode, whitelist, and blacklist.
19+
- PDF, Excel, CSV, and JSON exports.
20+
21+
## Privacy And Safety
22+
23+
- No telemetry is uploaded by default.
24+
- Reports are exported only when the user chooses an export action.
25+
- Findings are risk indicators, not legal conclusions.
26+
- The project does not crack software, generate keys, bypass activation, or collect license keys.
27+
28+
## Known Limitation
29+
30+
This beta build is not code-signed yet, so Windows SmartScreen may warn on first run.

0 commit comments

Comments
 (0)