中文ReadMe

MyBox: Set of Easy Tools

This is compute application to provide simple and easy functions. It’s free and open sources.

What’s New

2024-5-18 v6.8.1

• Add:
  • Write watermarks in PDF files in batch.
  • New data column type: Editable enumeration.
  • Documents: Test Environment, Base Functions’ Verification List, Compatibility Testing, Detailed Testing.
• Improve:
  • Redesign and implement “Data manufacture”. The base framework is: reader + operate + writers.
  • Options: Verify types when edit data; Verify types when save data.
  • Row expression: Set variable values by bindings. Placeholders are handled as variable names instead of variable values.
  • Row filter: When expression is not empty and its value is not true nor false, the row is not taken.
  • Data manufacture: Fix and enhance “Set Values”.
  • Simplify interface of “Data manufacture”.
  • Transparent can be set when customized colors.
  • “rtbufsize” and rotation can be set for ffmpeg.
  • Notes: Node can be any html which can include head.
• Solved problems:
  • Fail to switch language when default locale is not Chinese.
  • Row expression is messed when value is string of multiple lines.
  • In data manufacture, “Set Values” should not clear data rows when expression is invalid.
  • Errors popped when edit data row.
  • Icon is displayed as blank.
  • “Era” is converted wrongly when import data in database table.
  • Options of “Target file” in some interfaces do not work.
  • Transparent background is set wrongly when draw shape in SVG.
  • Options of “View” do not work for SVG.
  • Transparent does not work for colors in html.
  • Rename Files: Option “Fill zero” does not work when files number in table is not counted.
  • Directory Synchronize: Fail when select option “Delete files/directories existed In target path but not existed in source path”.
  • File Decompress Unarchive: Empty file names in selection list.
  • File Redundancy: Empty file names in result list.

Closed requirements/bugs in this version

Notice

Without enough testings, MyBox has low reliability and bad stability. When use MyBox, following may happen:

• Files/Data are damaged.
• Output wrong results.
• Functions fail.
• Other unexpected behaviours.

Download and Execution

Source Codes

Self-contain packages

Self-contain packages include all files and need not java env nor installation.

User can double click the launcher to start MyBox or run it by command line. The default “Open Method” of image/text/PDF files can be associated to MyBox and a file can be opened directly by MyBox by double clicking the file’s name.

Jar

When JRE or JDK(Oracle jdk or open jdk) is installed, jar can run:

Run following command to launch this program with Jar package:
java -jar MyBox.jar

A file path can follow the command as argument to be opened directly by MyBox. Example, following command will open the image:
java -jar MyBox.jar /tmp/a1.jpg

Versions

Contents of this document may be expired, but its links refer to the latest versions.

The latest versions and archived versions can be downloaded in following addresses:

Configuration

Configuration file is under “User Home”:

Add parameter “config="FilePath"” when run jar to change configuration file temporarily.
Function “Settings” can be used to change configuration values.

Migration

1. Each version has itself’s configuration file. New version can copy parameters from existed versions.
2. Data handled in each version are under “Data Directory” referred by it. Multiple versions can refer to same data directory.
3. MyBox is backward compatibility: Later version can work on data of previous versions. While forward compatibility is not supported: Wrong may happen when old version handles data of new version.

Backup and Recover

In MyBox:
1. To backup, copy directories to other places.
2. To recover, override current directories with backup directories.
3. Need not backup each directory under data path.
Predefined directories under data path are listed below:

Resource Addresses

Documents

Implementation

MyBox is based on following open sources:

Features

Cross Platforms

MyBox is implemented in pure Java and only based on open sources, and it can run on platforms which support Java 21.
Versions before v5.3 are based on Java 8.

Internationalized

1. All codes of MyBox are internationalized. Language can be switched in time.
2. Each langauge is defined in one resource file, like: “Messages_NAME.properties”.
3. Support adding new languages online. Table is provided with English as comparison. New langauges take effects at once.
   Example, the new language is named as “aa”, and its resource file is “Messages_aa.properties”.
4. Translated languages can be shared with others: Put the files under “mybox_languages” of data path and MyBox is aware of them immediately.
5. Embed Chinese and English, whose files are under path MyBox/src/main/resources/bundles/.

Personal

1. All functions are executed in local host.
2. All data are stored in local host.
3. No register/login/DataCenter/Cloud.
4. Access network only when user requests.
5. Only read/write data which user need.

Friendly

1. Provide tips of current function/interface.
2. Remember user’s inputs or selections, and provide histories list.
3. Interfaces can be adjusted and some panes can be hidden.
4. Behaviours of some controls can be chosen.
5. Provide context menu and function menu to texts/image/html/table/tree.
6. Current texts/image/html/data can be popped.
7. Clipboards of texts/image/data can be managed.
8. Provide examples and useful information.
9. Appearance of interface and controls can be chosen and modified.

Data Compatible

1. Exported data are in common text formats, like txt/csv/xml/json/html.
2. Imported data are in common text format, like txt/csv.
3. At least one exported format can be imported.
4. Imported data are self-contain, that original data can be rebuilt without extra data.

Embedded Database System

1. Derby is free and open sources:
   • When start MyBox for the first time, some seconds are cost to create internal database tables and write initial data.
   • All database files are under data path, so different target data sets can be handled by switching data paths.
   • Multiple MyBox instances can share data by visiting same data path.
   • When database files not found under data path(damaged or deleted unexpectedly), MyBox can create database automatically.
2. Derby runs in embedded mode by default:
   • External processes can not access the database.
   • Only one MyBox instance can use the database at the same time.
3. Derby can run in network mode:
   • The first visitor becomes the server.
   • Processes of local host can visit the database in port 1527 and becomes its clients.
   • Processes out of local host can not visit the database directly.
4. MyBox internal tables store the data required by all functions. User can access and modify the internal data online.
5. User can define customized database tables.
6. User can view and edit definitons and data of database tables in paginated tables, and execute SQL statements.
7. To implement data sorting, tranposing, statistic, and grouping, MyBox will create temporary database tables, and clear them in time.

Assit Coding Self

1. Monitor memory/CPU usage in real time.
2. Adjust logging online.
3. Generate icons automatically.
4. Edit and apply languages online.
5. Test automatically.
6. All kinds of documents.

Snapshots